List DNS Record Sets

POST

/enum.api.v1.DnsService/ListRecordSets

Authorizations

• bearerAuth

Request Body ^required

object

projectId

string

zoneId

string

Responses

200

OK

object

recordSets

Array<object>

DnsRecordSet is a resource record set: all values sharing (name, type) with one shared TTL. It is addressed by (zone_id, name, type).

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 is missing or invalid.

Messages:

• validation error: <field>: <reason>

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