Linode Instances
Networking Information List
https://api.linode.com/v4/linode/instances/{linodeId}/ips
Returns networking information for a single Linode.
Path Parameters
ID of the Linode to look up.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/linode/instances/123/ips
Response Samples
- 200
- default
{
"ipv4": {
"public": "",
"private": "",
"shared": "",
"reserved": ""
},
"ipv6": {
"link_local": {
"address": "fe80::f03c:91ff:fe24:3a2f",
"gateway": "fe80::1",
"subnet_mask": "ffff:ffff:ffff:ffff::",
"prefix": 64,
"type": "ipv6",
"public": "",
"rdns": "",
"linode_id": 123,
"region": "us-east"
},
"slaac": {
"address": "2600:3c03::f03c:91ff:fe24:3a2f",
"gateway": "fe80::1",
"subnet_mask": "ffff:ffff:ffff:ffff::",
"prefix": 64,
"type": "ipv6",
"public": true,
"rdns": "",
"linode_id": 123,
"region": "us-east"
},
"global": ""
}
}
Responses
200: Requested Linode's networking configuration.
Information about this Linode's IPv4 addresses.
A list of public IP Address objects belonging to this Linode.
A list of private IP Address objects belonging to this Linode.
A list of shared IP Address objects assigned to this Linode.
A list of reserved IP Address objects belonging to this Linode.
Information about this Linode's IPv6 addresses.
A link-local IPv6 address that exists in Linode's system,.
The IPv6 link-local address.
The default gateway for this address.
The subnet mask.
The network prefix.
The type of address this is.
Whether this is a public or private IP address.
The reverse DNS assigned to this address.
The ID of the Linode this address currently belongs to.
The Region this address resides in.
A SLAAC IPv6 address that exists in Linode's system.
The address.
The default gateway for this address.
The subnet mask.
The network prefix.
The type of address this is.
Whether this is a public or private IP address.
The reverse DNS assigned to this address.
The ID of the Linode this address currently belongs to.
The Region this address resides in.
A list of IPv6 range objects assigned to this Linode.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
IPv4 Address Allocate
https://api.linode.com/v4/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.
Path Parameters
ID of the Linode to look up.
Request Body Schema
Whether to create a public or private IPv4 address.
The type of address you are allocating. Only IPv4 addresses may be allocated through this endpoint.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"type": "ipv4",
"public": true
}' \
https://api.linode.com/v4/linode/instances/123/ips
Response Samples
- 200
- default
{
"public": true,
"type": "ipv4",
"region": "us-east",
"address": "97.107.143.141",
"gateway": "97.107.143.1",
"subnet_mask": "255.255.255.0",
"prefix": 24,
"rdns": "test.example.org",
"linode_id": 123
}
Responses
200: IP address was successfully allocated.
Whether this is a public or private IP address.
The type of address this is.
The Region this IP address resides in.
The IP address.
The default gateway for this address.
The mask that separates host bits from network bits for this address.
The number of bits set in the subnet mask.
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.
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 my be moved using the /networking/ipv4/assign endpoint. For SLAAC and link-local addresses, this value may not be changed.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.