Allocate an IPv4 address

post https://api.linode.com/{apiVersion}/linode/instances/{linodeId}/ips

Allocates a public or private IPv4 address to a Linode. Public IP Addresses, after the one included with each Linode, incur an additional monthly charge. If you need an additional public IP Address you must request one - please Open a support ticket. You may not add more than one private IPv4 address to a single Linode.

linode-cli linodes ip-add 123 \
  --type ipv4 \
  --public true


Learn more...

linodes:read_write


Learn more...

Responses

Response body

object

address

string

Read-only The IP address.

gateway

string | null

Read-only The default gateway for this address.

interface_id

integer | null

Beta, Read-only The Linode interface ID that this IP address is assigned to. This value is null if a Linode interface is not assigned, or if the IP is assigned to a legacy configuration profile interface.

linode_id

integer

Read-only The ID of the Linode this address currently belongs to. For IPv4 addresses, this is by default the Linode that this address was assigned to on creation, and these addresses may be moved using the Assign IPv4s to Linodes operation. For SLAAC and link-local addresses, this value can't be changed.

prefix

integer

Read-only The number of bits set in the subnet mask.

public

boolean

Read-only Whether this is a public or private IP address.

rdns

string | null

The reverse DNS assigned to this address. For public IPv4 addresses, this will be set to a default value provided by Linode if not explicitly set.

region

string

Read-only The Region this IP address resides in.

subnet_mask

string

Read-only The mask that separates host bits from network bits for this address.

type

string

Read-only The type of address this is.

ipv4 ipv6 ipv6/pool ipv6/range

vpc_nat_1_1

object

IPv4 address configured as a 1:1 NAT for this Interface. If no address is configured as a 1:1 NAT, null is returned.

📘
Only allowed for vpc type interfaces.

address

string

The IPv4 address that is configured as a 1:1 NAT for this VPC interface.

subnet_id

integer

The id of the VPC Subnet for this interface.

vpc_id

integer

Read-only The id of the VPC configured for this interface.

Language

Credentials


xxxxxxxxxx
10
1
curl --request POST \
2
     --url https://api.linode.com/v4/linode/instances/linodeId/ips \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "public": true,
8
  "type": "ipv4"
9
}
10
'


xxxxxxxxxx
17
 
1
{
2
  "address": "97.107.143.141",
3
  "gateway": "97.107.143.1",
4
  "interface_id": 456,
5
  "linode_id": 123,
6
  "prefix": 24,
7
  "public": true,
8
  "rdns": "test.example.org",
9
  "region": "us-east",
10
  "subnet_mask": "255.255.255.0",
11
  "type": "ipv4",
12
  "vpc_nat_1_1": {
13
    "address": "192.168.0.42",
14
    "subnet_id": 101,
15
    "vpc_id": 111
16
  }
17
}

200IP address was successfully allocated.

📘

defaultSee Errors for the range of possible error response codes.