This function updates a given DNS zone. It can add, edit,
and remove many records in a single call. It also ensures
that each record not removed will occupy the same
number of lines after the edit as it did before the edit.
SecurityBasicAuth
Request
query Parameters
serial
required
integer >= 0
The current serial number in the DNS zone’s SOA (Start of Authority)
record. If this value does not match the zone’s current state, the
request fails.
Example: serial=202001010100
zone
required
string
The name of one of the user’s DNS zones.
Example: zone=example.com
add
Array of strings <json>
The records to add to the zone. Each item must be a serialized
JSON object that contains:
dname — The record’s name.
ttl — The record’s TTL (Time-To-Live) value.
record_type — The record’s type. For example, A or TXT.
data — An array of strings. The format and number of the
strings depend on the record_type value.
The records to edit in the zone. Each item must be a serialized
JSON object that contains:
line_index — The line number in the DNS zone where the record starts.
This is a 0-based index, so to edit the first line in the file
use the 0 value. To edit the second line, give 1, and so forth.
dname — The record’s name.
ttl — The record’s TTL (Time-To-Live) value.
record_type — The record’s new type. For example, A or TXT.
data — An array of strings. The format and number of the
strings depend on the record_type value.