Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Update DNS zone

Used to update a DNS zone.

For managed zones the name servers and DNSSEC settings can only be changed trough domain update

For managed zones this call is als available on the url /v2/domains/domainName/zone/update
  • POSTMethod
  • /v2/dns/zones/zoneId/updateURL
  • application/jsonContent-Type
URL fields
Name Type Description Restrictions
zoneId Integer The DNS zone ID
Request content fields
Name Type Required / Optional Description Restrictions
template String Optional Name of the template to use
link Boolean Optional Unless false, the zone is linked to the template
master String Optional IP address of the (hidden) master. To convert a slave zone to a master zone, send an update command with empty value for master
ns List <String> Optional List of name servers for the DNS zone
  • Regular expression: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
  • Maximum number of items: 10
  • Minimum length: 4
  • Maximum length: 255
dnssec Boolean Optional Provision zone with DNSSEC
hostMaster String Optional The email address of the hostmaster
refresh Integer Optional The time when the slave will try to refresh the zone from the master, in seconds
retry Integer Optional The time between retries if the slave (secondary) fails to contact the master when refresh has expired, in seconds
  • Default Value: 3600
  • Minimum value: 1
expire Integer Optional Indicates when the zone data is no longer authoritative, in seconds
  • Default Value: 1209600
  • Maximum value: 4838400
  • Minimum value: 86400
ttl Integer Optional The duration that the record may be cached, in seconds
  • Default Value: 3600
  • Maximum value: 2419200
  • Minimum value: 60
records List < records > Optional DNS records
records
Name Type Required / Optional Description Restrictions
name String Required The full record name.
type Enum Required The record type

Possible values:

  • A: Address record
  • MX: Mail exchange record
  • CNAME: Canonical name record
  • AAAA: IPv6 address record
  • URL: URL Record
  • MBOXFW: Mailbox forward record
  • HINFO: Host information record
  • NAPTR: Naming Authority Pointer
  • NS: Name server record
  • SRV: Service locator
  • CAA: Certification Authority Authorization
  • TLSA: Transport Layer Security Authentication
  • ALIAS: ALIAS record
  • TXT: Text record
  • SOA: Start of [a zone of] authority record
  • DNSKEY: DNSKEY record
  • CERT: Certificate record
  • DS: DS record
  • LOC: Location record
  • SSHFP: SSH key record
  • URI: URI record
content String Required Type specific content of the record
ttl Integer Optional The duration that the record may be cached, in seconds (if not set, the default ttl of template (the ttl key in the request body) is used)
prio Integer Optional The priority, mandatory if "type" is MX or SRV

Successful request

DNS template has been updated successfully
  • 200 OKHTTP Status
  • application/jsonContent-Type

Failed requests

Besides the generic errors these specific error responses can be expected.

Error responses
Type Status Description
DnsConfigurationException 400 Bad Request The DNS records contain errors
URL fields
The DNS zone ID
Request parameters
Name of the template to use
Unless false, the zone is linked to the template

Specify as empty string: IP address of the (hidden) master. To convert a slave zone to a master zone, send an update command with empty value for master
List of name servers for the DNS zone
Provision zone with DNSSEC
The email address of the hostmaster
The time when the slave will try to refresh the zone from the master, in seconds
The time between retries if the slave (secondary) fails to contact the master when refresh has expired, in seconds
Indicates when the zone data is no longer authoritative, in seconds
The duration that the record may be cached, in seconds
records
The full record name.
The record type
Type specific content of the record
The duration that the record may be cached, in seconds (if not set, the default ttl of template (the ttl key in the request body) is used)
The priority, mandatory if "type" is MX or SRV
Request

POST /v2/dns/zones/zoneId/update
Content-Type: application/json 

{}
Response