DescribeDomainRecords - Alibaba Cloud DNS: Central de Documentação do Alibaba Cloud

Obtém os registros DNS de um domínio raiz especificado com base nos parâmetros de entrada.

Descrição da operação

Você pode especificar o nome de domínio (DomainName), o número da página (PageNumber) e o tamanho da página (PageSize) para obter uma lista de registros DNS.
Você pode especificar uma palavra-chave para o registro de host (RRKeyWord), tipo de registro (TypeKeyWord) ou valor do registro (ValueKeyWord) para consultar registros DNS que contenham a palavra-chave.
Por padrão, os registros DNS são classificados em ordem decrescente pelo horário em que foram adicionados.
Você pode especificar um ID de grupo de domínio (GroupId) para consultar os registros DNS em um grupo específico.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

alidns:DescribeDomainRecords

get

*Domain

acs:alidns::{#accountId}:domain/{#DomainName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Lang	string	Não	O idioma da solicitação e da resposta. Valor padrão: zh. Valores válidos: zh: Chinês en: Inglês	en
DomainName	string	Sim	O nome de domínio. Para mais informações, consulte DescribeDomains.	example.com
PageNumber	integer	Não	O número da página. O valor começa a partir de 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas a serem retornadas em cada página para uma consulta paginada. Valor máximo: 500. Valor padrão: 20.	20
KeyWord	string	Não	A palavra-chave.	test
RRKeyWord	string	Não	A palavra-chave para o registro de host. A pesquisa utiliza um padrão de correspondência difusa e não diferencia maiúsculas de minúsculas.	www
TypeKeyWord	string	Não	A palavra-chave para o tipo de registro. A pesquisa utiliza correspondência exata e não diferencia maiúsculas de minúsculas.	MX
ValueKeyWord	string	Não	A palavra-chave para o valor do registro. A pesquisa utiliza um padrão de correspondência difusa e não diferencia maiúsculas de minúsculas.	com
OrderBy	string	Não	O método de classificação. Os registros são classificados em ordem decrescente com base no horário em que foram adicionados.	default
Direction	string	Não	A direção de classificação. Valores válidos: DESC, ASC. Valor padrão: DESC.	DESC
SearchMode	string	Não	O modo de pesquisa. Valores válidos: LIKE, EXACT, ADVANCED e COMBINATION. Se você definir este parâmetro como LIKE ou EXACT, use o parâmetro KeyWord. Os parâmetros RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line e Status são inválidos. Se você definir este parâmetro como ADVANCED, use os parâmetros RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line e Status. Os parâmetros RRKeyWord e ValueKeyWord suportam correspondência difusa. Se você definir este parâmetro como COMBINATION, use os parâmetros RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line e Status. Todos esses parâmetros suportam apenas correspondência exata. Se você não especificar este parâmetro: Se você especificar o parâmetro keyWord, o modo de pesquisa será definido como LIKE. Se você não especificar o parâmetro keyWord, RRKeyWord e ValueKeyWord suportam correspondência difusa, e TypeKeyWord, Type, Line e Status suportam correspondência exata.	LIKE
GroupId	integer	Não	O ID do grupo de domínio. Se você não especificar GroupId, a consulta será realizada em todos os nomes de domínio. Se você definir GroupId como 0, um resultado vazio será retornado. Se você definir GroupId como -1, a consulta será realizada no grupo padrão. O grupo padrão inclui nomes de domínio que não foram atribuídos a um grupo. Se você definir GroupId como -2, a consulta será realizada em todos os nomes de domínio. Se você especificar outro valor para GroupId, a consulta será realizada no grupo especificado. Para mais informações, consulte DescribeDomainGroups.	2****
Type	string	Não	O tipo do registro DNS. Para mais informações, consulte: Tipos de registros DNS	A
Line	string	Não	A linha de resolução DNS. Valor padrão: default. Para mais informações, consulte: Enumeração de linhas de resolução DNS	cn_mobile_anhui
Status	string	Não	O status do registro DNS. Valores válidos: Enable: O registro DNS está ativado. Disable: O registro DNS está pausado.	Enable

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número total de registros DNS.	2
PageSize	integer	O número de registros DNS retornados nesta consulta.	20
RequestId	string	O ID da solicitação.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
DomainRecords	object
Record	array<object>	A lista de registros DNS.
	object
Status	string	The status of the DNS record.	Enable
Type	string	The record type.	MX
Remark	string	The remarks.	备注
TTL	integer	The time to live (TTL). Unit: seconds.	600
RecordId	string	The ID of the DNS record.	9*******
Priority	integer	The priority of the MX record.	5
RR	string	The host record.	www
DomainName	string	The domain name.	example.com
Weight	integer	The weight for load balancing.	2
Value	string	The record value.	mail1.hichina.com
Line	string	The DNS resolution line.	default
Locked	boolean	The lock status of the DNS record.	false
CreateTimestamp	integer	The time when the record was created. This is a UNIX timestamp.	1666501957000
UpdateTimestamp	integer	The time when the record was last updated. This is a UNIX timestamp.	1676872961000
LbaStatus	boolean	Indicates whether a load balancing policy is configured. true: Weight-based false: Polling-based	true
PageNumber	integer	O número da página atual.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 2,
  "PageSize": 20,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "DomainRecords": {
    "Record": [
      {
        "Status": "Enable",
        "Type": "MX",
        "Remark": "备注",
        "TTL": 600,
        "RecordId": "9*******",
        "Priority": 5,
        "RR": "www",
        "DomainName": "example.com",
        "Weight": 2,
        "Value": "mail1.hichina.com",
        "Line": "default",
        "Locked": false,
        "CreateTimestamp": 1666501957000,
        "UpdateTimestamp": 1676872961000,
        "LbaStatus": true
      }
    ]
  },
  "PageNumber": 1
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.