Create a zone

post

https://{hostname}/config-dns/v2/zones

Creates a new zone. Carefully review the documentation for which fields are relevant to the type of zone you're creating.

Query Params

contractId

string

required

The contract to use for the new zone.

gid

integer

required

The currently selected group ID to manage.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

comment

string

Free-form user comments.

contractId

string

The contract for this zone.

endCustomerId

string

Free-form user identifier for this zone, often used by resellers.

lastActivationDate

date-time

PRIMARY and SECONDARY zones only. An ISO 8601 timestamp showing when the latest version was activated.

lastModifiedBy

string

The user that last edited this zone.

lastModifiedDate

date-time

ISO 8601 timestamp marking when zone's last modification.

masters

array of strings

For SECONDARY zones only. The names or addresses of the customer's name servers that the zone data should be retrieved from.

masters

multiProviderDnssec

object

Multi-provider DNSSEC properties.

outboundZoneTransfer

object

Outbound zone transfer properties. When enabling outbound zone transfer, all the fields are required. Set tsigKey to null if you don't use it.

signAndServe

boolean

For PRIMARY and SECONDARY zones only. Indicates whether DNSSEC Sign&Serve enabled.

signAndServeAlgorithm

string

enum

The algorithm currently or last used for DNSSEC Sign&Serve, either RSA_SHA1, RSA_SHA256, RSA_SHA512, ECDSA_P256_SHA256, or ECDSA_P384_SHA384. Absent if no algorithm has ever been assigned to this zone.

Allowed:

subzoneGrants

boolean

Determines if cross-account subzones are enabled. This doesn't impact the ability to create subzones that you're presently authorized to edit.

target

string

For ALIAS zones only. The name of the zone whose configuration this zone copies.

tsigKey

object

A TSIG key. For SECONDARY zones only. The TSIG key used for zone transfers.

type

string

enum

required

The zone type. A PRIMARY zone's records are stored in Control Center. A SECONDARY zone's records are stored on the customer's name servers. ALIAS zones allow users to duplicate the configuration of an existing zone.

Allowed:

versionId

string

The UUID of the most recently activated version.

zone

string

required

The name of the zone.

Response

201Successful response.