Skip to main content
GET
Listar registros
Requer a ação do IAM dns:ListRecords. Consulte permissões de DNS para obter a lista completa, o que cada uma abrange e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Parâmetros de caminho

zone_id
string<uuid>
obrigatório

ID da zona DNS

Parâmetros de consulta

type
string

Tipo de registro exato para filtrar (por ex. A, MX).

Exemplo:

"A"

name
string

Nome exato do registro, em minúsculas com um ponto final opcional removido.

Exemplo:

"www.example.com"

crn
string

Exato CRN de registro aninhado. CRNs estrangeiros ou não correspondidos retornam uma página vazia; combinado com o nome antes da paginação.

include_managed
boolean
padrão:false

Inclua as linhas com carimbo de plataforma (SOA, NS de ápice e o conjunto DNSSEC) ao lado das suas próprias. Desligado por padrão — eles não podem ser editados ou excluídos, e em uma zona assinada há mais deles do que há de você.

Exemplo:

false

limit
integer
padrão:50
Intervalo obrigatório: 1 <= x <= 500
Exemplo:

50

marker
string<uuid>

Token de continuação — o último id de registro da página anterior.

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

Resposta

Lista de registros

records
object[]
meta
object