Replace record sets

put

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

Replaces all record sets that currently exist with the list provided.

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

One or more record sets.

recordsets

array of objects

required

length ≥ 1

A set of one or more resource records that share the same name, type, and TTL.

recordsets*

A set of one or more resource records that share the same name, type, and TTL.

name

string

required

The fully qualified domain name (FQDN) of this record.

rdata

array of strings

required

Each string encodes the rdata for a single record. If you want to have three A records, you need three strings in the array. Each string is encoded in master file format. RFC 1035 defines master file format for most record types.

rdata*

ttl

integer

required

≥ 0

The number of seconds this record should live in a resolver's cache before being refetched. A value of 0 means the record is uncached.

type

string

required

The record type.

Responses

204

Successful operation.

Language

URL

Loading…

Response

Choose an example:

application/problem+json

400Bad Request. A record set in the request is malformed, contains invalid data, or a CNAME collides with another record at the same name.

401Unauthorized. Your credentials are missing or invalid.

404Not Found. The specified zone doesn't exist or isn't accessible.

409Conflict. The zone is being modified concurrently.

412Precondition Failed. The If-Match header value doesn't match the zone's current ETag.

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

422Unprocessable Entity. A record set contains semantically invalid RDATA, such as an invalid SOA, DS, CDS, or CDNSKEY record.