put
https://api.linode.com//networking/ips/
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
rdnstonullfor public IPv4 addresses, it resets to the defaultip.linodeusercontent.comRDNS 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
reservedtotrueon an ephemeral IP converts it to a reserved IP. - Setting
reservedtofalseon 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
- Scopes:
CLI
linode-cli networking ip-update \
203.0.113.1 \
--rdns "test.example.org" \
--reserved true