PUT - Update a specific PTR record

Purpose

This API call updates a PTR record in a specified DNS zone. PTR records are critical for reverse DNS resolution, which allows the identification of hostnames linked to specific IP addresses. By modifying PTR records, administrators ensure accurate reverse lookup information for IP addresses in the network.

Request URL

Method: PUT

https://{appconsole_IP}:{9443}/api/dns/zone/{zone_pk}/PTR/{pk}/

Request Headers

The following headers must be included in the API request for successful authentication and data submission:

Authorization: DDI Central's OAuth implementation uses the Bearer authentication scheme. Hence, while making API calls, access_token obtained via the OAuth 2.0 Client Credentials Grant must be included in the Authorization header of API requests. This token verifies the client’s identity and ensures appropriate permissions for accessing resources.

The Authorization Header follows the format below:

headers = { "Authorization": "Bearer {bearer_tk}" }


Content-Type: Required in the header to indicate the media type of the resource being sent. It helps the server at the receiving end understand how to process the transmitted request body.

The Content-Type Header follows the format below:

headers ={ "Content-Type": "application/json" }

Path Parameters

  • zone_pk* long
    • Denotes the primary key (ID) of the DNS zone containing the record.
  • pk* long
    • Denotes the primary key (ID) of the specific PTR record to be updated.

Request Body

  • domain_name* string
    • The fully qualified domain name (FQDN) for which the PTR record is being updated.
  • domain_ttl* integer
    • Time-to-Live value for the record, indicating how long the record should be cached by resolvers.
  • zone_name* string
    • The DNS zone where the PTR record resides.
  • records* an array of string
    • A list of PTR record values representing the hostnames mapped to the IP address.
  • cluster_name* string
    • The cluster under which the zone is managed.

 

* - Mandatory parameter.

 

Sample Request

Copied
{
  "domain_name": "ptr49.hellotest109.com.",
  "domain_ttl": 86400,
  "zone_name": "hellotest109.com.",
  "cluster_name": "wincluster-zoho",
  "records": [
    "ptr1.local.",
    "ptr2.local.",
    "ptr3.local."
  ],
  
}

Sample Response

Copied
{
  "domain_name": "ptr49.hellotest109.com.",
  "domain_ttl": 86400,
  "ptr_domain_id": "560",
  "zone_id": 5867,
  "zone_name": "hellotest109.com.",
  "cluster_name": "wincluster-zoho",
  "records": [
    "ptr1.local.",
    "ptr2.local.",
    "ptr3.local."
  ]
}