# Exemplos do registro de domínios do Route 53 usando o AWS CLI
Os exemplos de código a seguir mostram como implementar cenários comuns usando o AWS Command Line Interface com o registro de domínios do Route 53.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `check-domain-availability`
O código de exemplo a seguir mostra como usar `check-domain-availability`.
**AWS CLI**
**Para determinar se você pode registrar um nome de domínio com o Route 53**
O comando `check-domain-availability` a seguir informa se o nome de domínio `example.com` está ou não disponível para ser registrado usando o Route 53.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains check-domain-availability \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"Availability": "UNAVAILABLE"
}
```
O Route 53 é compatível com um grande número de domínios do nível superior (TLDs), como `.com` e `.jp`, mas não com todos os TLDs disponíveis. Se você verificar a disponibilidade de um domínio e o Route 53 não for compatível com o TLD, `check-domain-availability` retornará a mensagem a seguir.
```
An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: tld is not supported.
```
Para obter uma lista dos TLDs genéricos que você pode usar para registrar domínios com o Route 53, consulte [Domains That You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) no *Guia do desenvolvedor do Amazon Route 53*. Para obter mais informações sobre registro de domínios com o Route 53, consulte [Registrar um novo domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CheckDomainAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-availability.html) na *Referência de comandos da AWS CLI*.
### `check-domain-transferability`
O código de exemplo a seguir mostra como usar `check-domain-transferability`.
**AWS CLI**
**Para determinar se um domínio pode ser transferido para o Route 53**
O comando `check-domain-transferability` a seguir retorna informações sobre a possibilidade de transferir um nome de domínio `example.com` para o Route 53.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains check-domain-transferability \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"Transferability": {
"Transferable": "UNTRANSFERABLE"
}
}
```
Para obter mais informações, consulte [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CheckDomainTransferability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-transferability.html) na *Referência de comandos da AWS CLI*.
### `delete-tags-for-domain`
O código de exemplo a seguir mostra como usar `delete-tags-for-domain`.
**AWS CLI**
**Para excluir tags de um domínio**
O comando `delete-tags-for-domain` a seguir exclui três tags do domínio especificado. Observe que você especifica somente a chave da tag, não o valor da tag.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains delete-tags-for-domain \
--region us-east-1 \
--domain-name example.com \
--tags-to-delete accounting-key hr-key engineering-key
```
Este comando não produz saída.
Para confirmar que as tags foram excluídas, você pode executar [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html). Para obter mais informações, consulte [Marcar recursos do Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DeleteTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/delete-tags-for-domain.html) na *Referência de comandos da AWS CLI*.
### `disable-domain-auto-renew`
O código de exemplo a seguir mostra como usar `disable-domain-auto-renew`.
**AWS CLI**
**Para desativar a renovação automática de um domínio**
O comando `disable-domain-auto-renew` a seguir configura o Route 53 para *não* renovar automaticamente o domínio `example.com` antes que o registro do domínio expire.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains disable-domain-auto-renew \
--region us-east-1 \
--domain-name example.com
```
Este comando não produz saída.
Para confirmar que a configuração foi alterada, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Se a renovação automática estiver desabilitada, o valor de `AutoRenew` é `False`. Para obter mais informações sobre renovação automática, consulte Renovação do registro de um domínio
O código de exemplo a seguir mostra como usar `disable-domain-transfer-lock`.
**AWS CLI**
**Para desativar o bloqueio de transferência em um domínio**
O comando `disable-domain-transfer-lock` a seguir remove o bloqueio de transferência no domínio `example.com` para que o domínio possa ser transferido para outro registrador. Esse comando altera o status de `clientTransferProhibited`.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains disable-domain-transfer-lock \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que o bloqueio de transferência foi alterado, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Quando o bloqueio de transferência está desabilitado, o valor de `StatusList` *não* inclui `clientTransferProhibited`.
Para obter mais informações sobre o processo de transferência, consulte [Transferir um domínio do Amazon Route 53 para outro registrador](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DisableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/disable-domain-transfer-lock.html) na *Referência de comandos da AWS CLI*.
### `enable-domain-auto-renew`
O código de exemplo a seguir mostra como usar `enable-domain-auto-renew`.
**AWS CLI**
**Para habilitar a renovação automática de um domínio**
O comando `enable-domain-auto-renew` a seguir configura o Route 53 para renovar automaticamente o domínio `example.com` antes que o registro do domínio expire.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains enable-domain-auto-renew \
--region us-east-1 \
--domain-name example.com
```
Este comando não produz saída. Para confirmar que a configuração foi alterada, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Se a renovação automática estiver habilitada, o valor de `AutoRenew` é `True`.
Para obter mais informações sobre renovação automática, consulte Renovação do registro de um domínio
O código de exemplo a seguir mostra como usar `enable-domain-transfer-lock`.
**AWS CLI**
**Para habilitar o bloqueio de transferência em um domínio**
O comando `enable-domain-transfer-lock` a seguir bloqueia o domínio especificado para que ele não possa ser transferido para outro registrador. Esse comando altera o status de `clientTransferProhibited`.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains enable-domain-transfer-lock \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que o bloqueio de transferência foi alterado, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Quando o bloqueio de transferência está habilitado, o valor de `StatusList` inclui `clientTransferProhibited`.
Para obter mais informações sobre o processo de transferência, consulte [Transferir um domínio do Amazon Route 53 para outro registrador](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [EnableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/enable-domain-transfer-lock.html) na *Referência de comandos da AWS CLI*.
### `get-contact-reachability-status`
O código de exemplo a seguir mostra como usar `get-contact-reachability-status`.
**AWS CLI**
**Como determinar se o contato do registrante respondeu a um e-mail de confirmação**
O comando `get-contact-reachability-status` a seguir retorna informações sobre se o contato do solicitante do registro do domínio especificado respondeu a um e-mail de confirmação.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains get-contact-reachability-status \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"domainName": "example.com",
"status": "DONE"
}
```
Para obter mais informações, consulte [Reenviar e-mails de autorização e confirmação](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetContactReachabilityStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-contact-reachability-status.html) na *Referência de comandos da AWS CLI*.
### `get-domain-detail`
O código de exemplo a seguir mostra como usar `get-domain-detail`.
**AWS CLI**
**Para obter informações detalhadas sobre um domínio especificado**
O comando `get-domain-detail` a seguir exibe informações sobre o domínio especificado.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains get-domain-detail \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"DomainName": "example.com",
"Nameservers": [
{
"Name": "ns-2048.awsdns-64.com",
"GlueIps": []
},
{
"Name": "ns-2049.awsdns-65.net",
"GlueIps": []
},
{
"Name": "ns-2050.awsdns-66.org",
"GlueIps": []
},
{
"Name": "ns-2051.awsdns-67.co.uk",
"GlueIps": []
}
],
"AutoRenew": true,
"AdminContact": {
"FirstName": "Saanvi",
"LastName": "Sarkar",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ssarkar@example.com",
"ExtraParams": []
},
"RegistrantContact": {
"FirstName": "Alejandro",
"LastName": "Rosalez",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "arosalez@example.com",
"ExtraParams": []
},
"TechContact": {
"FirstName": "Wang",
"LastName": "Xiulan",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "wxiulan@example.com",
"ExtraParams": []
},
"AdminPrivacy": true,
"RegistrantPrivacy": true,
"TechPrivacy": true,
"RegistrarName": "Amazon Registrar, Inc.",
"WhoIsServer": "whois.registrar.amazon",
"RegistrarUrl": "http://registrar.amazon.com",
"AbuseContactEmail": "abuse@registrar.amazon.com",
"AbuseContactPhone": "+1.2062661000",
"CreationDate": 1444934889.601,
"ExpirationDate": 1602787689.0,
"StatusList": [
"clientTransferProhibited"
]
}
```
+ Para ver detalhes da API, consulte [GetDomainDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-detail.html) na *Referência de comandos da AWS CLI*.
### `get-domain-suggestions`
O código de exemplo a seguir mostra como usar `get-domain-suggestions`.
**AWS CLI**
**Para obter uma lista de nomes de domínio sugeridos**
O comando `get-domain-suggestions` a seguir exibe uma lista de nomes de domínio sugeridos com base no nome de domínio `example.com`. A resposta só inclui os nomes de domínio que estão disponíveis. Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains get-domain-suggestions \
--region us-east-1 \
--domain-name example.com \
--suggestion-count 10 \
--only-available
```
Resultado:
```
{
"SuggestionsList": [
{
"DomainName": "egzaampal.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplelaw.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplehouse.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "homeexample.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplelist.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplenews.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "officeexample.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "exampleworld.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "exampleart.com",
"Availability": "AVAILABLE"
}
]
}
```
+ Para ver detalhes da API, consulte [GetDomainSuggestions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-suggestions.html) na *Referência de comandos da AWS CLI*.
### `get-operation-detail`
O código de exemplo a seguir mostra como usar `get-operation-detail`.
**AWS CLI**
**Para obter o status atual de uma operação**
Algumas operações de registro de domínio são executadas de modo assíncrono e retornam uma resposta antes de serem concluídas. Essas operações retornam um ID de operação que você pode usar para obter o status atual. O comando `get-operation-detail` retorna o status da operação especificada.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains get-operation-detail \
--region us-east-1 \
--operation-id edbd8d63-7fe7-4343-9bc5-54033example
```
Resultado:
```
{
"OperationId": "edbd8d63-7fe7-4343-9bc5-54033example",
"Status": "SUCCESSFUL",
"DomainName": "example.com",
"Type": "DOMAIN_LOCK",
"SubmittedDate": 1573749367.864
}
```
+ Para ver detalhes da API, consulte [GetOperationDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-operation-detail.html) na *Referência de comandos da AWS CLI*.
### `list-domains`
O código de exemplo a seguir mostra como usar `list-domains`.
**AWS CLI**
**Para listar os domínios que estão registrados na conta atual da AWS**
O comando `list-domains` lista informações resumidas sobre as os domínios que estão registrados na conta atual da AWS.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains list-domains
--region us-east-1
```
Resultado:
```
{
"Domains": [
{
"DomainName": "example.com",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602712345.0
},
{
"DomainName": "example.net",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602723456.0
},
{
"DomainName": "example.org",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602734567.0
}
]
}
```
+ Para ver detalhes da API, consulte [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-domains.html) na *Referência de comandos da AWS CLI*.
### `list-operations`
O código de exemplo a seguir mostra como usar `list-operations`.
**AWS CLI**
**Para listar o status das operações que retornam um ID de operação**
Algumas operações de registro de domínio são executadas de modo assíncrono e retornam uma resposta antes de serem concluídas. Essas operações retornam um ID de operação que você pode usar para obter o status atual. O comando `list-operations` a seguir lista informações resumidas, incluindo o status, sobre as operações atuais de registro de domínio.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains list-operations
--region us-east-1
```
Resultado:
```
{
"Operations": [
{
"OperationId": "aab9822f-1da0-4bf3-8a15-fd4e0example",
"Status": "SUCCESSFUL",
"Type": "DOMAIN_LOCK",
"SubmittedDate": 1455321739.986
},
{
"OperationId": "c24379ed-76be-42f8-bdad-9379bexample",
"Status": "SUCCESSFUL",
"Type": "UPDATE_NAMESERVER",
"SubmittedDate": 1468960475.109
},
{
"OperationId": "f47e1297-ef9e-4c2b-ae1e-a5fcbexample",
"Status": "SUCCESSFUL",
"Type": "RENEW_DOMAIN",
"SubmittedDate": 1473561835.943
},
{
"OperationId": "75584f23-b15f-459e-aed7-dc6f5example",
"Status": "SUCCESSFUL",
"Type": "UPDATE_DOMAIN_CONTACT",
"SubmittedDate": 1547501003.41
}
]
}
```
A saída inclui todas as operações que retornam um ID de operação e que você executou em todos os domínios que registrou usando a conta atual da AWS. Se desejar obter apenas as operações enviadas após uma determinada data, você pode incluir o parâmetro `submitted-since` e especificar uma data no formato Unix e no Horário Universal Coordenado (UTC). O comando a seguir obtém o status de todas as operações enviadas após as 12h UTC de 1º de janeiro de 2020.
```
aws route53domains list-operations \
--submitted-since 1577836800
```
+ Para ver detalhes da API, consulte [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-operations.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-domain`
O código de exemplo a seguir mostra como usar `list-tags-for-domain`.
**AWS CLI**
**Para listar tags para um domínio**
O comando `list-tags-for-domain` a seguir lista as tags associadas ao domínio especificado.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains list-tags-for-domain \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"TagList": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
]
}
```
Para obter mais informações, consulte [Marcar recursos do Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-tags-for-domain.html) na *Referência de comandos da AWS CLI*.
### `register-domain`
O código de exemplo a seguir mostra como usar `register-domain`.
**AWS CLI**
**Para registrar um domínio**
O comando `register-domain` a seguir registra um domínio, recuperando todos os valores de parâmetros de um arquivo no formato JSON.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains register-domain \
--region us-east-1 \
--cli-input-json file://register-domain.json
```
Conteúdo de `register-domain.json`:
```
{
"DomainName": "example.com",
"DurationInYears": 1,
"AutoRenew": true,
"AdminContact": {
"FirstName": "Martha",
"LastName": "Rivera",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mrivera@example.com"
},
"RegistrantContact": {
"FirstName": "Li",
"LastName": "Juan",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ljuan@example.com"
},
"TechContact": {
"FirstName": "Mateo",
"LastName": "Jackson",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mjackson@example.com"
},
"PrivacyProtectAdminContact": true,
"PrivacyProtectRegistrantContact": true,
"PrivacyProtectTechContact": true
}
```
Resultado:
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar `get-operation-detail`. Para obter mais informações, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).
Para obter mais informações, consulte [Registrar um novo domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) no *Guia do desenvolvedor do Amazon Route 53*.
Para obter informações sobre quais domínios do nível superior (TLDs) exigem valores para `ExtraParams` e quais são os valores válidos, consulte [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html) na *Amazon Route 53 API Reference*.
+ Para ver detalhes da API, consulte [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html) na *Referência de comandos da AWS CLI*.
### `renew-domain`
O código de exemplo a seguir mostra como usar `renew-domain`.
**AWS CLI**
**Como renovar um domínio**
O comando `renew-domain` a seguir renova o domínio especificado por cinco anos. Para obter o valor de `current-expiry-year`, use o comando `get-domain-detail` e converta o valor de `ExpirationDate` do formato Unix.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains renew-domain \
--region us-east-1 \
--domain-name example.com \
--duration-in-years 5 \
--current-expiry-year 2020
```
Resultado:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation-detail`. Para obter mais informações, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).
O registro de cada domínio de primeiro nível (TLD), como .com ou .org, controla o número máximo de anos pelos quais você pode renovar um domínio. Para obter o período máximo de renovação de seu domínio, consulte a seção “Período de registro e renovação” de seu TLD em [Domínios que você pode registrar com o Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) no *Guia do desenvolvedor do Amazon Route 53*.
Para obter mais informações, consulte [Renovar o registro de um domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [RenewDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/renew-domain.html) na *Referência de comandos da AWS CLI*.
### `resend-contact-reachability-email`
O código de exemplo a seguir mostra como usar `resend-contact-reachability-email`.
**AWS CLI**
**Como reenviar o e-mail de confirmação para o endereço de e-mail atual do contato do registrante**
O comando `resend-contact-reachability-email` a seguir reenvia o e-mail de confirmação ao endereço de e-mail atual do contato do registrante para o domínio example.com.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains resend-contact-reachability-email \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"domainName": "example.com",
"emailAddress": "moliveira@example.com",
"isAlreadyVerified": true
}
```
Se o valor de `isAlreadyVerified` for `true`, como neste exemplo, o contato do registrante já confirmou que o endereço de e-mail especificado está acessível.
Para obter mais informações, consulte [Reenviar e-mails de autorização e confirmação](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ResendContactReachabilityEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/resend-contact-reachability-email.html) na *Referência de comandos da AWS CLI*.
### `retrieve-domain-auth-code`
O código de exemplo a seguir mostra como usar `retrieve-domain-auth-code`.
**AWS CLI**
**Para obter o código de autorização de um domínio para que você possa transferir o domínio para outro registrador**
O comando `retrieve-domain-auth-code` a seguir obtém o código de autorização atual para o domínio example.com. Você atribui esse valor a outro registrador de domínio quando deseja transferir o domínio para esse registrador.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains retrieve-domain-auth-code \
--region us-east-1 \
--domain-name example.com
```
Resultado:
```
{
"AuthCode": ")o!v3dJeXampLe"
}
```
Para obter mais informações, consulte [Transferir um domínio do Amazon Route 53 para outro registrador](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [RetrieveDomainAuthCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/retrieve-domain-auth-code.html) na *Referência de comandos da AWS CLI*.
### `transfer-domain`
O código de exemplo a seguir mostra como usar `transfer-domain`.
**AWS CLI**
**Como transferir um domínio para o Amazon Route 53**
O comando `transfer-domain` a seguir transfere um domínio para o Route 53, com os parâmetros fornecidos pelo arquivo formatado em JSON `C:\temp\transfer-domain.json`.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains transfer-domain \
--region us-east-1 \
--cli-input-json file://C:\temp\transfer-domain.json
```
Conteúdo de `transfer-domain.json`:
```
{
"DomainName": "example.com",
"DurationInYears": 1,
"Nameservers": [
{
"Name": "ns-2048.awsdns-64.com"
},
{
"Name": "ns-2049.awsdns-65.net"
},
{
"Name": "ns-2050.awsdns-66.org"
},
{
"Name": "ns-2051.awsdns-67.co.uk"
}
],
"AuthCode": ")o!v3dJeXampLe",
"AutoRenew": true,
"AdminContact": {
"FirstName": "Martha",
"LastName": "Rivera",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mrivera@example.com"
},
"RegistrantContact": {
"FirstName": "Li",
"LastName": "Juan",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ljuan@example.com"
},
"TechContact": {
"FirstName": "Mateo",
"LastName": "Jackson",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mjackson@example.com"
},
"PrivacyProtectAdminContact": true,
"PrivacyProtectRegistrantContact": true,
"PrivacyProtectTechContact": true
}
```
Resultado:
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar `get-operation-detail`. Para obter mais informações, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).
Para obter mais informações, consulte [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [TransferDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/transfer-domain.html) na *Referência de comandos da AWS CLI*.
### `update-domain-contact-privacy`
O código de exemplo a seguir mostra como usar `update-domain-contact-privacy`.
**AWS CLI**
**Para atualizar as configurações de privacidade dos contatos de um domínio**
O comando `update-domain-contact-privacy` a seguir desativa a proteção de privacidade do contato administrativo do domínio example.com. Esse comando só pode ser executado na região `us-east-1`.
Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains update-domain-contact-privacy \
--region us-east-1 \
--domain-name example.com \
--no-admin-privacy
```
Resultado:
```
{
"OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar `get-operation-detail`. Para obter mais informações, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).
Para obter mais informações, consulte [Habilitar ou desabilitar a proteção de privacidade para informações de contato de um domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-privacy-protection.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateDomainContactPrivacy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact-privacy.html) na *Referência de comandos da AWS CLI*.
### `update-domain-contact`
O código de exemplo a seguir mostra como usar `update-domain-contact`.
**AWS CLI**
**Para atualizar as informações de contato de um domínio**
O comando `update-domain-contact` a seguir atualiza as informações de contato de um domínio, obtendo os parâmetros do arquivo formatado em JSON `C:\temp\update-domain-contact.json`.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains update-domain-contact \
--region us-east-1 \
--cli-input-json file://C:\temp\update-domain-contact.json
```
Conteúdo de `update-domain-contact.json`:
```
{
"AdminContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
},
"DomainName": "example.com",
"RegistrantContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
},
"TechContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
}
}
```
Resultado:
```
{
"OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Para obter mais informações, consulte [Atualizar informações de contato de um domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-update-contacts.html#domain-update-contacts-basic) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateDomainContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact.html) na *Referência de comandos da AWS CLI*.
### `update-domain-nameservers`
O código de exemplo a seguir mostra como usar `update-domain-nameservers`.
**AWS CLI**
**Para atualizar os servidores de nome para um domínio**
O comando `update-domain-nameservers` a seguir atualiza os servidores de nomes de um domínio.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains update-domain-nameservers \
--region us-east-1 \
--domain-name example.com \
--nameservers Name=ns-1.awsdns-01.org Name=ns-2.awsdns-02.co.uk Name=ns-3.awsdns-03.net Name=ns-4.awsdns-04.com
```
Resultado:
```
{
"OperationId": "f1691ec4-0e7a-489e-82e0-b19d3example"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html).
Para obter mais informações, consulte [Adicionar ou alterar servidores de nomes e registros cola para um domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-name-servers-glue-records.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateDomainNameservers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-nameservers.html) na *Referência de comandos da AWS CLI*.
### `update-tags-for-domain`
O código de exemplo a seguir mostra como usar `update-tags-for-domain`.
**AWS CLI**
**Para adicionar ou atualizar tags para um domínio**
O comando `update-tags-for-domain` a seguir adiciona ou atualiza duas chaves e os valores correspondentes para o domínio example.com. Para atualizar o valor de uma chave, basta incluir a chave e o novo valor. Você pode adicionar ou atualizar tags em apenas um domínio por vez.
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains update-tags-for-domain \
--region us-east-1 \
--domain-name example.com \
--tags-to-update "Key=key1,Value=value1" "Key=key2,Value=value2"
```
Este comando não produz saída. Para confirmar se as tags foram adicionadas ou atualizadas, você pode executar [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html).
Para obter mais informações, consulte [Marcar recursos do Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-tags-for-domain.html) na *Referência de comandos da AWS CLI*.
### `view-billing`
O código de exemplo a seguir mostra como usar `view-billing`.
**AWS CLI**
**Para obter informações de faturamento de custos de registro de domínios da conta atual da AWS**
O comando `view-billing` a seguir retorna todos os registros de faturamento referentes a domínios para a conta atual no período de 1º de janeiro de 2018 (1514764800 no horário Unix) e meia-noite de 31 de dezembro de 2019 (1577836800 no horário Unix).
Esse comando só pode ser executado na região `us-east-1`. Se sua região padrão estiver definida como `us-east-1`, você poderá omitir o parâmetro `region`.
```
aws route53domains view-billing \
--region us-east-1 \
--start-time 1514764800 \
--end-time 1577836800
```
Resultado:
```
{
"BillingRecords": [
{
"DomainName": "example.com",
"Operation": "RENEW_DOMAIN",
"InvoiceId": "149962827",
"BillDate": 1536618063.181,
"Price": 12.0
},
{
"DomainName": "example.com",
"Operation": "RENEW_DOMAIN",
"InvoiceId": "290913289",
"BillDate": 1568162630.884,
"Price": 12.0
}
]
}
```
Para obter mais informações, consulte [ViewBilling](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ViewBilling.html) na *Amazon Route 53 API Reference*.
+ Para ver detalhes da API, consulte [ViewBilling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/view-billing.html) na *Referência de comandos da AWS CLI*.