Sign in
Primary IP Actions

Change reverse DNS records for a Primary IP

Change the reverse DNS records for this Primary IP.

Allows to modify the PTR records set for the IP address.

post/primary_ips/{id}/actions/change_dns_ptr

Request

  • Base URL: https://api.hetzner.cloud/v1
  • URL: https://api.hetzner.cloud/v1/primary_ips/{id}/actions/change_dns_ptr
  • Auth: HTTP bearer

Path parameters

idinteger required

ID of the Primary IP.

Example:42

ID of the Primary IP.

Request body

ipstring required

Single IPv4 or IPv6 address to create pointer for.

dns_ptrstring nullable required

Domain Name to point to.

PTR record content used for reverse DNS. Set to null to reset (IPv4) to the default value or remove (IPv6) the record.

Example request

{
  "ip": "2001:db8::1",
  "dns_ptr": "server.example.com"
}

Response

Request succeeded.

Example response

{
  "action": {
    "id": 42,
    "command": "start_resource",
    "started": "2016-01-30T23:55:00Z",
    "finished": "2016-01-30T23:55:00Z",
    "progress": 100,
    "resources": [
      {
        "id": 42,
        "type": "server"
      }
    ],
    "error": {
      "code": "action_failed",
      "message": "Action failed"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.