Remove a value from a DNS Record Set

POST

/enum.api.v1.DnsService/RemoveRecordSetValue

Authorizations

• bearerAuth

Request Body ^required

RemoveRecordSetValue removes one value from the (name, type) rrset, deleting the whole set once its last value is gone.

object

projectId

string

zoneId

string

name

string

type

string

content

string

Responses

200

OK

object

recordSet

Unset when the removal emptied and deleted the rrset.

object

id

string

zoneId

string

name

Owner name (FQDN, e.g. www.example.com or example.com for apex).

string

type

Record type: A, AAAA, CNAME, MX, TXT, NS, SRV, or CAA. A CNAME at the zone apex flattens to the target’s A/AAAA addresses when served; unlike CNAME elsewhere, it may coexist with MX, TXT, and CAA at the apex (not with A or AAAA).

string

ttl

integer format: int32

records

Array<object>

object

content

Rdata in presentation format (e.g. “192.0.2.1”, “10 mail.example.com.”).

string

disabled

boolean

createdAt

string format: date-time

updatedAt

string format: date-time

400

invalid_argument: a field or the value is invalid.

Messages:

• validation error: <field>: <reason>
• invalid <type> rdata "<value>"
• A record content must be an IPv4 address, got "<value>" (AAAA and IPv6 likewise)

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string

401

unauthenticated: the token is missing, invalid, or expired.

Messages:

• missing authorization header
• invalid authorization header format
• authentication failed

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string

403

permission_denied: the token has no access to this project or method.

Messages:

• not authorized

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string

404

not_found: the resource does not exist.

Messages:

• resource not found

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string

429

resource_exhausted: the token’s rate limit is reached.

Messages:

• rate limit exceeded: wait for the number of seconds in Retry-After.

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string

500

internal: something failed on our side.

Messages:

• internal error

object

code

Error code, such as invalid_argument or not_found.

string

message

Human-readable error message.

string