Azion CLI dns-zone
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem zonas do Edge DNS, com cada flag, seu tipo e seu padrão.
Os comandos dns-zone da Azion CLI criam, listam, descrevem, atualizam e excluem zonas, o objeto do Edge DNS que guarda um domínio e os seus registros. Os campos de uma zona, os seus limites e os erros que a API retorna estão em Zonas e registros. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Criar
azion create dns-zone cria uma zona para o domínio que você informa:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | — | true | Ativa (--active=true) ou desativa (--active=false) a zona. |
--domain | — | string | — | Obrigatório, a menos que --file esteja definida. Domínio que a zona atende. Sem ela, o comando pergunta o domínio. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos da zona. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Nome da zona. |
Este comando cria uma zona chamada my-zone para o domínio my-domain.com:
O comando imprime o ID da zona:
Um domínio que outra conta hospeda é recusado com ["Domain Belongs to Another Account."], e um domínio que já tem uma zona na sua conta é recusado com ["This field must be unique."]. Os dois erros são explicados em Zonas e registros.
Listar
azion list dns-zone lista as zonas da sua conta, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Aceita, e imprime as mesmas colunas ID, NAME, DOMAIN e ACTIVE da lista simples. |
--filter | — | string | — | Nome pelo qual filtrar a lista. |
--order-by | — | string | — | Campo pelo qual ordenar a lista. |
--page | — | int | 1 | Número da página a retornar. |
--page-size | — | int | 50 | Número de zonas em cada página. |
Este comando lista todas as zonas da conta:
O comando imprime uma linha por zona, com o seu domínio e o seu estado:
Descrever
azion describe dns-zone imprime as configurações de uma zona:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--zone-id | — | int | — | Obrigatório. ID da zona a descrever. |
Este comando descreve a zona com ID 1235:
O comando imprime a zona e os nameservers da Azion que respondem pelo seu domínio:
Com --format json, o comando imprime o mesmo objeto com as chaves active, domain, id, name, nameservers e product_version.
Atualizar
azion update dns-zone altera o nome ou o estado ativo de uma zona. O comando não tem flag para o domínio:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | — | true | Ativa (--active=true) ou desativa (--active=false) a zona. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Novo nome da zona. |
--zone-id | — | int | — | Obrigatório. ID da zona a atualizar. |
Escreva --active com sinal de igual. Com um espaço, --active false imprime DNS zone 1234 was updated e deixa a zona ativa.
Este comando desativa a zona com ID 1234:
O comando confirma a atualização:
Excluir
azion delete dns-zone exclui uma zona:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--zone-id | — | int | — | Obrigatório. ID da zona a excluir. |
Este comando exclui a zona com ID 1235:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create dns-zone e azion update dns-zone leem os atributos da zona de um arquivo JSON com --file.
Este arquivo cria uma zona chamada my-file-zone para my-file-domain.com e a mantém desativada. O comando lê name, domain e active do arquivo:
Informe o arquivo ao comando de criação:
O comando imprime o ID da zona:
Na atualização, informe o ID da zona com --zone-id. Este arquivo renomeia a zona e a ativa:
Informe o arquivo ao comando de atualização:
O comando confirma a atualização: