Update an IP address

Updates the configuration of an existing IP address. Use this operation to set Reverse DNS (RDNS) and to toggle the reserved status of an IPv4 address. You can update both the reserved status and the rdns field in a single request, if the IP is assigned to a Linode.

RDNS:

  • Forward DNS must already be set up for reverse DNS to be applied.
  • If you set the rdns to null for public IPv4 addresses, it resets to the default ip.linodeusercontent.com RDNS value.
  • You can't set RDNS on an unassigned reserved IP. The IP must be assigned to a Linode to update its RDNS record.

Reserved IP:

  • Setting reserved to true on an ephemeral IP converts it to a reserved IP.
  • Setting reserved to false on a reserved IP converts it to an ephemeral IP. If you convert an unassigned reserved IP to ephemeral, the IP is immediately released from your account. Unreserving this IP removes it from your reserved list and makes it unavailable to assign. This action can't be undone.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: ips:read_write

CLI

linode-cli networking ip-update \
  203.0.113.1 \
  --rdns "test.example.org" \
  --reserved true

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
string
required

The address to operate on.

Body Params
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.

boolean | null

The reserved status of an IPv4 address.

  • Setting reserved to true on an ephemeral IP converts it to a reserved IP.
  • Setting reserved to false on a reserved IP converts it to an ephemeral IP.
Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json