This API method is a shortcut to remove everything in the zone from this point down the tree. It removes the identified node, any records within the node, and any nodes underneath the identified node. Only use this method when absolutely necessary. Do not use this method if the records are to be recreated shortly.
NOTE: Use this method ONLY for cleaning up a zone. Regular node or record deletes should use the Delete A Records (API) method. Once all node records are removed, the node is automatically removed.
Understanding How The API Works »
REST Syntax
| Click to view all REST Resources |
| Node/ DELETE — Removes the indicated node, any records within the node, and any nodes underneath the node.
HTTP Action — DELETE
URI — https://api.dynect.net/REST/Node /<zone>/<FQDN>/ |
| Arguments:
No Arguments. |
Response — Click for More Info
- integer
serial — The current serial number of the zone
- string
serial_style — The style of the zone’s serial number.
Valid values:
increment – Serials are incremented by 1 on every change.
epoch – Serials will be the UNIX timestamp at the time of the publish.
day – Serials will be in the form of YYYYMMDDxx where xx is incremented by one for each change during that particular day.
minute – Serials will be in the form of YYMMDDHHMM.
- string
zone The name of the requested zone
- string
zone_type — Type of zone.
Valid values:
Primary
Secondary
|
SOAP Syntax
| Click to view all SOAP Commands |
| PruneZone — Removes the indicated node, any records within the node, and any nodes underneath the node. |
Arguments:
- string
FQDN — Required. FQDN of node to delete.
- string
token — Required. The session identifier.
- string
zone — Required. Name of zone to remove.
|
Response — Click for More Info
- hash
data
- string
serial — The current serial number of the zone.
- string
serial_style — The style of the zone’s serial number.
Valid values:
increment – Serials are incremented by 1 on every change.
epoch – Serials will be the UNIX timestamp at the time of the publish.
day – Serials will be in the form of YYYYMMDDxx where xx is incremented by one for each change during that particular day.
minute – Serials will be in the form of YYMMDDHHMM.
- string
zone — Name of the zone.
- string
zone_type — Type of zone.
Valid values:
primary
secondary
|
Example Request — Click for More Info
{
'fqdn' => 'old.example.com',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
DNS API Knowledge Base
