Linode Instances
IP Address View
https://api.linode.com/v4/linode/instances/{linodeId}/ips/{address}View information about the specified IP address associated with the specified Linode.
Path Parameters
The ID of the Linode.
The IP address.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/linode/instances/123/ips/97.107.143.141
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: A single IP address.
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.
IP Address RDNS Update
https://api.linode.com/v4/linode/instances/{linodeId}/ips/{address}Updates the reverse DNS (RDNS) for a Linode's IP Address. This may be done for both IPv4 and IPv6 addresses.
Setting the RDNS to null for a public IPv4 address, resets it to the default "ip.linodeusercontent.com" RDNS value.
Path Parameters
The ID of the Linode.
The IP address.
Request Body Schema
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.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PUT -d '{
"rdns": "test.example.org"
}' \
https://api.linode.com/v4/linode/instances/123/ips/203.0.113.1
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: The updated IP address record.
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.
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 Delete
https://api.linode.com/v4/linode/instances/{linodeId}/ips/{address}Deletes a public or private IPv4 address associated with this Linode. This will fail if it is the Linode's last remaining public IPv4 address.
Path Parameters
The ID of the Linode.
The IP address.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X DELETE \
https://api.linode.com/v4/linode/instances/123/ips/97.107.143.141
Response Samples
- 200
- default
{}Responses
200: IP address successfully removed.
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.