Skip to main content
POST
Importar um arquivo de zona
Requer a ação do IAM dns:ImportZoneFile. 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.

Cabeçalhos

Idempotency-Key
string

Chave opcional gerada pelo cliente que torna uma criação segura para reprodução. A reintentar uma solicitação com a mesma chave retorna o resultado original literalmente em vez de criar um recurso duplicado. A reutilização de uma chave com um corpo de solicitação diferente é rejeitada (422); uma solicitação cuja chave ainda está sendo processada retorna 409. Os registros são honrados por 24 horas. Use um UUID ou token exclusivo semelhante.

Maximum string length: 255

Parâmetros de caminho

zone_id
string<uuid>
obrigatório

ID da zona DNS

Corpo

zone_file
string
obrigatório

O arquivo de zona, como texto. $ORIGIN, $TTL, $GENERATE, nomes relativos e registros de várias linhas entre parênteses são todos honrados; $INCLUDE é recusado, porque o caminho que ele nomeia seria lido em nosso sistema de arquivos ao invés do seu.

Exemplo:

"$ORIGIN example.com.\n$TTL 3600\nwww IN A 203.0.113.10\n@ IN MX 10 mail.example.com.\ndkim IN TXT \"v=DKIM1; k=rsa; p=MIIBIjANBgkqh\"\n"

Resposta

O arquivo foi importado. Leia skipped antes de concluir que a zona corresponde ao arquivo.

import
object

O que a importação fez. records_created mais records_replaced é cada RRset retirado do arquivo; qualquer coisa em skipped ainda está no arquivo, mas não na zona.