Delete DNS zone record

This function deletes a DNS zone record.

Warning:

Incorrect use of this function could cause domains to resolve incorrectly. Exercise extreme caution when you remove DNS zone records.

To effectively use this function, use the following workflow:

Run the dumpzone function.
Locate the Line value that corresponds to the zone record to delete.
Use the values from that zone record to formulate the appropriate removezonerecord parameters.

Important:

When you disable the DNS role, the system disables this function.
You cannot use this function to modify temporary domains.

get/removezonerecord

Query parameters

lineinteger required

Example:4

The DNS zone record file's line number.

zonestring domain required

Example:example.com

The zone record's domain.

serialnumstring

Example:2013122501

The zone file's serial number.

This parameter defaults to the zone file's current serial number.

Response

HTTP Request was successful.

Example response

{
  "metadata": {
    "command": "removezonerecord",
    "reason": "Bind reloading on hostname using rndc zone: [example.com]\n",
    "result": 1,
    "version": 1
  }
}