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

Chama AddZoneRecord para adicionar um registro DNS autoritativo integrado. Dentro do escopo de resolução efetivo, os registros DNS da rede interna do nome de domínio sobrescrevem seus registros DNS da rede pública.

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

pvtz:AddZoneRecord

create

*Zona.

acs:pvtz::{#accountId}:zone/{#ZoneId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ZoneId	string	Sim	O ID da zona, que é o identificador exclusivo da zona.	df2d03865266bd9842306db586d3****
Lang	string	Não	O idioma da resposta. Valores válidos: zh: Chinês. en: Inglês. Valor padrão: en.	en
Rr	string	Sim	O registro de nome de host. O registro de nome de host é o prefixo do nome de domínio. Os valores comuns incluem www, @, * (registro DNS curinga) e mail (comumente usado para e-mail). Por exemplo, para resolver @.example.com, defina o registro de nome de host como @ em vez de deixá-lo vazio.	www
Type	string	Sim	O tipo de registro DNS. Valores válidos: A: Mapeia o nome de domínio para um endereço IPv4 no formato decimal com pontos. AAAA: Mapeia o nome de domínio para um endereço IPv6. CNAME: Mapeia o nome de domínio para outro nome de domínio. TXT: Especifica uma string de texto de até 255 caracteres de comprimento. É normalmente usado para registros Sender Policy Framework (SPF) para evitar spam. MX: Mapeia o nome de domínio para o nome de domínio de um servidor de e-mail. PTR: Mapeia um endereço IP para um nome de domínio. SRV: Registra o servidor que fornece um serviço específico. O formato é prioridade peso porta endereço de destino, com cada item separado por um espaço. Nota Antes de adicionar um registro PTR, você deve configurar uma zona de resolução reversa. Para mais informações, consulte Resolução reversa e registros PTR.	A
Line	string	Não	A origem da consulta DNS. Valores válidos: default: A linha DNS padrão, que equivale a uma linha global. Recomendamos que você configure a linha padrão como fallback para garantir que um registro DNS seja retornado quando nenhuma linha inteligente for correspondida. Alibaba Cloud line: Indica que a consulta DNS se origina da Alibaba Cloud, incluindo a nuvem pública, Finance Cloud e Gov Cloud. Custom line: Permite personalizar a resolução de nomes de domínio internos para retornar endereços IP específicos para consultas DNS de um bloco CIDR específico. Nota Apenas nomes de domínio em zonas aceleradas autoritativas integradas suportam a adição de linhas de origem de consulta DNS. Para selecionar a resolução padrão, insira default. Para a linha da Alibaba Cloud e linhas personalizadas, você deve inserir o código de linha especificado. Exemplo: aliyun_r_cn-beijing-a.	default
Weight	integer	Não	O valor do peso. O valor deve ser um número inteiro de 1 a 100. Valor padrão: 1. Você pode definir diferentes valores de peso para cada endereço para que as consultas DNS retornem endereços com base na proporção de peso.	1
Ttl	integer	Não	O tempo de vida (TTL) do cache local. Valores válidos: 5, 30, 60, 3600 (1 hora), 43200 (12 horas) e 86400 (24 horas). Unidade: segundos. Valor padrão: 60.	60
Priority	integer	Não	A prioridade do registro MX. Um valor menor indica uma prioridade maior. Valores válidos: [1,99].	5
Value	string	Sim	O valor do registro. Especifique o valor do registro com base no tipo de registro DNS.	114.55.XX.XX
UserClientIp	string	Não	O endereço IP do usuário.	127.0.XX.XX
Remark	string	Não	A observação.	en
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token pode conter no máximo 64 caracteres ASCII.	6447728c8578e66aacf062d2df4446dc

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0B7AD377-7E86-44A8-B9A8-53E8666E72FE
RecordId	integer	O ID do registro DNS.	429570****
Success	boolean	Indica se a solicitação foi bem-sucedida.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0B7AD377-7E86-44A8-B9A8-53E8666E72FE",
  "RecordId": 0,
  "Success": true
}

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.