Update change list settings

put

https://{hostname}/config-dns/v2/changelists/{zone}/settings

Updates the change list with new Zone settings. The entire Zone object is needed no matter how many fields you're updating.

Path Params

zone

string

required

The name of the zone.

Query Params

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

An Edge DNS zone. This object contains zone settings, but not record sets.

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.

masters

array of strings

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

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

required

Whether DNSSEC Sign&Serve is enabled. Applies to primary and secondary zones only.

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

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:

zone

string

required

The name of the zone.

Responses

204

Successful response.

Language

URL

Loading…

Response

Choose an example:

application/problem+json

400Bad Request. The request body contains an invalid field value or the zone type is not supported by this operation.

401Unauthorized. Your credentials are missing or invalid.

404Not Found. The specified zone or its change list doesn't exist.

409Conflict. The zone is locked for deletion.

412Precondition Failed. The If-Match header value doesn't match the change list's current tag.

415Unsupported Media Type. The request's Content-Type header is not supported. Use application/json.

422Unprocessable Entity. The request body contains a semantically invalid field value.