

# Ejemplos de registro de dominios de Route 53 usando AWS CLI
<a name="cli_route-53-domains_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con el registro de dominios de Route 53.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `check-domain-availability`
<a name="route-53-domains_CheckDomainAvailability_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `check-domain-availability`.

**AWS CLI**  
**Para determinar si se puede registrar un nombre de dominio con Route 53**  
El siguiente comando `check-domain-availability` devuelve información sobre si el nombre de dominio `example.com` está disponible para registrarse utilizando Route 53.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains check-domain-availability \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "Availability": "UNAVAILABLE"
}
```
Route 53 admite una gran cantidad de dominios de nivel superior (TLD), como `.com` y`.jp`, pero no se admiten todos los TLD disponibles. Si comprueba la disponibilidad de un dominio y Route 53 no admite el TLD, `check-domain-availability` devuelve el siguiente mensaje.  

```
An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: <top-level domain> tld is not supported.
```
Para obtener una lista de los TLD que puede usar para registrar un dominio con Route 53 consulte [Domains That You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) en la *Guía para desarrolladores de Amazon Route 53*. Para obtener más información sobre el uso de Route 53 para registrar un dominio, consulte [Registering a New Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [CheckDomainAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-availability.html) en la *Referencia de comandos de la AWS CLI*. 

### `check-domain-transferability`
<a name="route-53-domains_CheckDomainTransferability_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `check-domain-transferability`.

**AWS CLI**  
**Para determinar si un dominio puede transferirse a Route 53**  
El siguiente comando `check-domain-transferability` devuelve información sobre si se puede transferir el nombre de dominio `example.com` a Route 53.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains check-domain-transferability \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "Transferability": {
        "Transferable": "UNTRANSFERABLE"
    }
}
```
Para obtener más información, consulte [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para ver los detalles de la API, consulte [CheckDomainTransferability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-transferability.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-tags-for-domain`
<a name="route-53-domains_DeleteTagsForDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-tags-for-domain`.

**AWS CLI**  
**Para eliminar las etiquetas de un dominio**  
El siguiente comando `delete-tags-for-domain` elimina tres etiquetas del dominio especificado. Tenga en cuenta que solo especifica la clave de la etiqueta, no el valor de la etiqueta.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el 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 no genera ninguna salida.  
Para confirmar que se eliminaron las etiquetas, puede ejecutar [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html). Para obtener más información, consulte [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [DeleteTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/delete-tags-for-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `disable-domain-auto-renew`
<a name="route-53-domains_DisableDomainAutoRenew_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `disable-domain-auto-renew`.

**AWS CLI**  
**Para deshabilitar la renovación automática de un dominio**  
El siguiente comando `disable-domain-auto-renew` configura Route 53 para que *no* renueve automáticamente el dominio `example.com` antes de que caduque el registro del dominio.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains disable-domain-auto-renew \
    --region us-east-1 \
    --domain-name example.com
```
Este comando no genera ninguna salida.  
Para confirmar que se ha cambiado la configuración, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Si la renovación automática está deshabilitada, el valor de `AutoRenew` es `False`. Para obtener más información sobre la renovación automática, consulte Renewing Registration for a Domain < https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [DisableDomainAutoRenew](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/disable-domain-auto-renew.html) en la *Referencia de comandos de la AWS CLI*. 

### `disable-domain-transfer-lock`
<a name="route-53-domains_DisableDomainTransferLock_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `disable-domain-transfer-lock`.

**AWS CLI**  
**Para deshabilitar el bloqueo de transferencia en un dominio**  
El siguiente comando `disable-domain-transfer-lock` elimina el bloqueo de transferencia del dominio `example.com` para que el dominio se pueda transferir a otro registrador. Este comando cambia el estado `clientTransferProhibited`.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains disable-domain-transfer-lock \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que se ha cambiado el bloqueo de transferencia, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Cuando el bloqueo de transferencia está desactivado, el valor de `StatusList` *no* incluye`clientTransferProhibited`.  
Para obtener más información, consulte [Transferring a Domain from Amazon Route 53 to Another Registrar](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [DisableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/disable-domain-transfer-lock.html) en la *Referencia de la comandos de la AWS CLI*. 

### `enable-domain-auto-renew`
<a name="route-53-domains_EnableDomainAutoRenew_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `enable-domain-auto-renew`.

**AWS CLI**  
**Para habilitar la renovación automática de un dominio**  
El siguiente comando `enable-domain-auto-renew` configura Route 53 para que renueve automáticamente el dominio `example.com` antes de que caduque el registro del dominio.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains enable-domain-auto-renew \
    --region us-east-1 \
    --domain-name example.com
```
Este comando no genera ninguna salida. Para confirmar que se ha cambiado la configuración, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Si la renovación automática está habilitada, el valor de `AutoRenew` es `True`.  
Para obtener más información sobre la renovación automática, consulte Renewing Registration for a Domain < https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [EnableDomainAutoRenew](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/enable-domain-auto-renew.html) en la *Referencia de comandos de la AWS CLI*. 

### `enable-domain-transfer-lock`
<a name="route-53-domains_EnableDomainTransferLock_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `enable-domain-transfer-lock`.

**AWS CLI**  
**Para habilitar el bloqueo de transferencia en un dominio**  
El siguiente comando `enable-domain-transfer-lock` bloquea de transferencia del dominio especificado para que no se pueda transferir a otro registrador. Este comando cambia el estado `clientTransferProhibited`.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains enable-domain-transfer-lock \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que se ha cambiado el bloqueo de transferencia, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Cuando el bloqueo de transferencia está activado, el valor de `StatusList` incluye `clientTransferProhibited`.  
Para obtener más información, consulte [Transferring a Domain from Amazon Route 53 to Another Registrar](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [EnableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/enable-domain-transfer-lock.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-contact-reachability-status`
<a name="route-53-domains_GetContactReachabilityStatus_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-contact-reachability-status`.

**AWS CLI**  
**Para determinar si el contacto titular ha respondido a un correo electrónico de confirmación**  
El siguiente comando `get-contact-reachability-status` devuelve información sobre si el contacto titular del dominio especificado ha respondido a un correo electrónico de confirmación.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains get-contact-reachability-status \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "domainName": "example.com",
    "status": "DONE"
}
```
Para obtener más información, consulte [Resending Authorization and Confirmation Emails](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [GetContactReachabilityStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-contact-reachability-status.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-domain-detail`
<a name="route-53-domains_GetDomainDetail_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-domain-detail`.

**AWS CLI**  
**Para obtener información detallada acerca de un dominio específico**  
El siguiente comando `get-domain-detail` muestra información detallada sobre el dominio especificado.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains get-domain-detail \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "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 obtener información sobre la API, consulte [GetDomainDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-detail.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-domain-suggestions`
<a name="route-53-domains_GetDomainSuggestions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-domain-suggestions`.

**AWS CLI**  
**Para obtener una lista de los nombres de dominio sugeridos**  
El siguiente comando `get-domain-suggestions` muestra una lista de los nombres de dominio sugeridos en función del nombre de dominio `example.com`. La respuesta incluye solo los nombres de dominio que están disponibles. Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains get-domain-suggestions \
    --region us-east-1 \
    --domain-name example.com \
    --suggestion-count 10 \
    --only-available
```
Salida:  

```
{
    "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 obtener información sobre la API, consulte [GetDomainSuggestions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-suggestions.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-operation-detail`
<a name="route-53-domains_GetOperationDetail_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-operation-detail`.

**AWS CLI**  
**Para obtener el estado actual de una operación**  
Algunas operaciones de registro de dominio funcionan de forma asíncrona y devuelven una respuesta antes de que finalicen. Estas operaciones devuelven un ID de operación que puede usar para obtener el estado actual. El siguiente comando `get-operation-detail` devuelve el estado de la operación especificada.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains get-operation-detail \
    --region us-east-1 \
    --operation-id edbd8d63-7fe7-4343-9bc5-54033example
```
Salida:  

```
{
    "OperationId": "edbd8d63-7fe7-4343-9bc5-54033example",
    "Status": "SUCCESSFUL",
    "DomainName": "example.com",
    "Type": "DOMAIN_LOCK",
    "SubmittedDate": 1573749367.864
}
```
+  Para obtener información sobre la API, consulte [GetOperationDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-operation-detail.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-domains`
<a name="route-53-domains_ListDomains_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-domains`.

**AWS CLI**  
**Para enumerar los dominios que están registrados en la cuenta actual de AWS**  
El siguiente comando `list-domains` enumera información resumida acerca de los dominios que están registrados en la cuenta actual de AWS.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains list-domains
    --region us-east-1
```
Salida:  

```
{
    "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 obtener información sobre la API, consulte [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-domains.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-operations`
<a name="route-53-domains_ListOperations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-operations`.

**AWS CLI**  
**Para enumerar el estado de las operaciones que devuelven un ID de operación**  
Algunas operaciones de registro de dominios se ejecutan de forma asíncrona y devuelven una respuesta antes de que finalicen. Estas operaciones devuelven un ID de operación que puede usar para obtener el estado actual. El siguiente comando `list-operations` enumera información resumida, incluido el estado, sobre las operaciones actuales de registro de dominio.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains list-operations
    --region us-east-1
```
Salida:  

```
{
    "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
        }
    ]
}
```
El resultado incluye todas las operaciones que devuelven un ID de operación y que ha realizado en todos los dominios que haya registrado alguna vez con la cuenta actual de AWS. Si desea obtener solo las operaciones que envió después de una fecha específica, puede incluir el parámetro `submitted-since` y especificar una fecha en formato Unix y en hora universal coordinada (UTC). El siguiente comando obtiene el estado de todas las operaciones que se enviaron después de las 00.00 h UTC del 1 de enero de 2020.  

```
aws route53domains list-operations \
    --submitted-since 1577836800
```
+  Para obtener información sobre la API, consulte [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-operations.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-tags-for-domain`
<a name="route-53-domains_ListTagsForDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-domain`.

**AWS CLI**  
**Para generar una lista de las etiquetas de un dominio**  
El siguiente comando `list-tags-for-domain` genera una lista de las etiquetas asignadas actualmente al dominio especificado.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains list-tags-for-domain \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": "value2"
        }
    ]
}
```
Para obtener más información, consulte [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [ListTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-tags-for-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `register-domain`
<a name="route-53-domains_RegisterDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `register-domain`.

**AWS CLI**  
**Para registrar un dominio**  
El siguiente comando `register-domain` registra un dominio y recupera todos los valores de los parámetros de un archivo con formato JSON.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains register-domain \
    --region us-east-1 \
    --cli-input-json file://register-domain.json
```
Contenido 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
}
```
Salida:  

```
{
    "OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar `get-operation-detail`. Para obtener más información, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).  
Para obtener más información, consulte [Registering a New Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) en la *Guía para desarrolladores de Amazon Route 53*.  
Para obtener información sobre los dominios de nivel superior (TLD) que requieren valores `ExtraParams` y cuáles son los valores válidos, consulte [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html) en la *Referencia de la API de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `renew-domain`
<a name="route-53-domains_RenewDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `renew-domain`.

**AWS CLI**  
**Para renovar un dominio**  
El siguiente comando `renew-domain` renueva el dominio especificado durante cinco años. Para obtener el valor de `current-expiry-year`, utilice el comando `get-domain-detail` y convierta el valor de `ExpirationDate` desde el formato Unix.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains renew-domain \
    --region us-east-1 \
    --domain-name example.com \
    --duration-in-years 5 \
    --current-expiry-year 2020
```
Salida:  

```
{
    "OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar `get-operation-detail`. Para obtener más información, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).  
El registro de cada dominio de nivel superior (TLD), como .com o .org, controla el número máximo de años durante los que se puede renovar un dominio. Para obtener el período de renovación máximo para su dominio, consulte la sección período de registro y renovación de su TLD en [Domains That You Can Register with Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) en la *Guía para desarrolladores de Amazon Route 53*.  
Para obtener más información, consulte [Renewing Registration for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [RenewDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/renew-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `resend-contact-reachability-email`
<a name="route-53-domains_ResendContactReachabilityEmail_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `resend-contact-reachability-email`.

**AWS CLI**  
**Para reenviar el correo electrónico de confirmación a la dirección de correo actual para el contacto titular**  
El siguiente comando `resend-contact-reachability-email` reenvía el correo electrónico de confirmación a la dirección de correo electrónico actual para el contacto titular del dominio example.com.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains resend-contact-reachability-email \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "domainName": "example.com",
    "emailAddress": "moliveira@example.com",
    "isAlreadyVerified": true
}
```
Si el valor de `isAlreadyVerified` es`true`, como en este ejemplo, el contacto titular ya ha confirmado que se puede acceder a la dirección de correo electrónico especificada.  
Para obtener más información, consulte [Resending Authorization and Confirmation Emails](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [ResendContactReachabilityEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/resend-contact-reachability-email.html) en la *Referencia de comandos de la AWS CLI*. 

### `retrieve-domain-auth-code`
<a name="route-53-domains_RetrieveDomainAuthCode_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `retrieve-domain-auth-code`.

**AWS CLI**  
**Para obtener el código de autorización de un dominio para poder transferirlo a otro titular**  
El siguiente comando `retrieve-domain-auth-code` obtiene el código de autorización actual para el dominio example.com. Le proporciona este valor a otro titular de dominios cuando desea transferir el dominio a ese titular.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains retrieve-domain-auth-code \
    --region us-east-1 \
    --domain-name example.com
```
Salida:  

```
{
    "AuthCode": ")o!v3dJeXampLe"
}
```
Para obtener más información, consulte [Transferring a Domain from Amazon Route 53 to Another Registrar](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener detalles sobre la API, consulte [RetrieveDomainAuthCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/retrieve-domain-auth-code.html) en la *Referencia de comandos de la AWS CLI*. 

### `transfer-domain`
<a name="route-53-domains_TransferDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `transfer-domain`.

**AWS CLI**  
**Para transferir un dominio a Amazon Route 53**  
El siguiente comando `transfer-domain` transfiere un dominio a Route 53, con los parámetros proporcionados por el archivo con formato JSON `C:\temp\transfer-domain.json`.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains transfer-domain \
    --region us-east-1 \
    --cli-input-json file://C:\temp\transfer-domain.json
```
Contenido 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
}
```
Salida:  

```
{
    "OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar `get-operation-detail`. Para obtener más información, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).  
Para obtener más información, consulte [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [TransferDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/transfer-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-domain-contact-privacy`
<a name="route-53-domains_UpdateDomainContactPrivacy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-domain-contact-privacy`.

**AWS CLI**  
**Para actualizar la configuración de privacidad de los contactos de un dominio**  
El siguiente comando `update-domain-contact-privacy` desactiva la protección de privacidad del contacto administrativo del dominio example.com. Este comando solo se ejecuta en la región `us-east-1`.  
Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains update-domain-contact-privacy \
    --region us-east-1 \
    --domain-name example.com \
    --no-admin-privacy
```
Salida:  

```
{
    "OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar `get-operation-detail`. Para obtener más información, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).  
Para obtener más información, consulte [Enabling or Disabling Privacy Protection for Contact Information for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-privacy-protection.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información acerca de la API, consulte [UpdateDomainContactPrivacy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact-privacy.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-domain-contact`
<a name="route-53-domains_UpdateDomainContact_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-domain-contact`.

**AWS CLI**  
**Para actualizar la información de contacto de un dominio**  
El siguiente comando `update-domain-contact` actualiza la información de contacto de un dominio y obtiene los parámetros del archivo con formato JSON `C:\temp\update-domain-contact.json`.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains update-domain-contact \
    --region us-east-1 \
    --cli-input-json file://C:\temp\update-domain-contact.json
```
Contenido 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"
    }
}
```
Salida:  

```
{
    "OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html). Para obtener más información, consulte [Updating Contact Information for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-update-contacts.html#domain-update-contacts-basic) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [UpdateDomainContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-domain-nameservers`
<a name="route-53-domains_UpdateDomainNameservers_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-domain-nameservers`.

**AWS CLI**  
**Para actualizar los servidores de nombres de un dominio**  
El siguiente comando `update-domain-nameservers` actualiza los servidores de nombres de un dominio.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el 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
```
Salida:  

```
{
    "OperationId": "f1691ec4-0e7a-489e-82e0-b19d3example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html).  
Para obtener más información, consulte [Adding or Changing Name Servers and Glue Records for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-name-servers-glue-records.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [UpdateDomainNameservers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-nameservers.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-tags-for-domain`
<a name="route-53-domains_UpdateTagsForDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-tags-for-domain`.

**AWS CLI**  
**Para añadir o actualizar las etiquetas de un dominio**  
El siguiente comando `update-tags-for-domain` agrega o actualiza dos claves y los valores correspondientes para el dominio example.com. Para actualizar el valor de una clave, simplemente incluya la clave y el valor nuevo. Puede agregar o actualizar etiquetas solo en un dominio a la vez.  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el 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 no genera ninguna salida. Para confirmar que se agregaron o actualizaron las etiquetas, puede ejecutar [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html).  
Para obtener más información, consulte [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html) en la *Guía para desarrolladores de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [UpdateTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-tags-for-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `view-billing`
<a name="route-53-domains_ViewBilling_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `view-billing`.

**AWS CLI**  
**Para obtener la información de facturación de los cargos por registro de dominio de la cuenta actual de AWS**  
El siguiente comando `view-billing` devuelve todos los registros de facturación relacionados con el dominio de la cuenta actual durante el período comprendido entre el 1 de enero de 2018 (1514764800 en horario Unix) y la medianoche del 31 de diciembre de 2019 (1577836800 en horario Unix).  
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.  

```
aws route53domains view-billing \
    --region us-east-1 \
    --start-time 1514764800 \
    --end-time 1577836800
```
Salida:  

```
{
    "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 obtener más información, consulte [ViewBilling](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ViewBilling.html) en la *Referencia de la API de Amazon Route 53*.  
+  Para obtener información sobre la API, consulte [ViewBilling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/view-billing.html) en la *Referencia de comandos de la AWS CLI*. 