Modify record set for a change list

post

https://{hostname}/config-dns/v2/changelists/{zone}/recordsets/add-change

Adds a record set change to this change list. Each change is an operation that affects a single record set: ADD, EDIT, or DELETE.

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

A modification of a record set inside a change list.

name

string

required

The DNS name of this record.

string

enum

required

The requested operation. You can ADD, EDIT, or DELETE a record set.

Allowed:

rdata

array of strings

Data strings, representing multiple records within a set. The format of the rdata strings depend on the type of this record. Not used when PATCHing a DELETE operation.

rdata

ttl

integer

≥ 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. Not used when PATCHing a DELETE operation.

type

string

required

The record type.

Responses

204

Successful response.

Language

URL

Loading…

Response

Choose an example:

application/problem+json

400Bad Request. A record set in the request is malformed or contains invalid data.

401Unauthorized. Your credentials are missing or invalid.

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

409Conflict. The change list already contains a conflicting change, or 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. A record set contains semantically invalid RDATA, or a change list add or delete operation is invalid.