DELETE - Delete a specific CNAME record

Purpose

The API deletes a specific CNAME record for the given domain name within a Windows DNS cluster environment. 

Note: If the CNAME record is actively used for domain aliasing, deleting it may cause service interruptions.

Ensure there is a valid replacement record (A or AAAA) if needed before deletion.

Review DNS configurations and dependencies to prevent unintended website or service downtime.

Check if subdomains or external services rely on the CNAME record before removing it.

Request URL

https://{appconsole_IP}:{9443}/api/dns/zone/{zone_pk}/CNAME/{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
    • This denotes the unique identifier for the zone.
  • pk* long
    • This denotes the unique identifier for the record.

 

* - Mandatory parameter.

 

Sample Response

Copied
Copied{
"message":"Deleted successfully"
}