Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Ejemplos de Route 53 usando AWS CLI Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con 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 ### `change-resource-record-sets` En el siguiente ejemplo de código, se muestra cómo utilizar `change-resource-record-sets`. **AWS CLI** **Para crear, actualizar o eliminar un conjunto de registros de recursos** El siguiente comando `change-resource-record-sets` crea un conjunto de registros de recursos mediante `hosted-zone-id` `Z1R8UBAEXAMPLE` y la configuración con formato JSON del archivo `C:\awscli\route53\change-resource-record-sets.json`: ``` aws route53 change-resource-record-sets --hosted-zone-id Z1R8UBAEXAMPLE --change-batch file://C:\awscli\route53\change-resource-record-sets.json ``` Para obtener más información, consulte POST ChangeResourceRecordSets en la *referencia de la API de Amazon Route 53*. La configuración del archivo JSON depende del tipo de conjunto de registros de recursos que quiera crear: BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Alias **Sintaxis básica**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "TTL": time to live in seconds, "ResourceRecords": [ { "Value": "applicable value for the record type" }, {...} ] } }, {...} ] } ``` **Sintaxis ponderada**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Weight": value between 0 and 255, "TTL": time to live in seconds, "ResourceRecords": [ { "Value": "applicable value for the record type" }, {...} ], "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis de alias**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "AliasTarget": { "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone", "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone", "EvaluateTargetHealth": true|false }, "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis de alias ponderada**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Weight": value between 0 and 255, "AliasTarget": { "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone", "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone", "EvaluateTargetHealth": true|false }, "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis de latencia**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Region": "Amazon EC2 region name", "TTL": time to live in seconds, "ResourceRecords": [ { "Value": "applicable value for the record type" }, {...} ], "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis de alias de latencia**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Region": "Amazon EC2 region name", "AliasTarget": { "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone", "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone", "EvaluateTargetHealth": true|false }, "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis de conmutación por error**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Failover": "PRIMARY" | "SECONDARY", "TTL": time to live in seconds, "ResourceRecords": [ { "Value": "applicable value for the record type" }, {...} ], "HealthCheckId": "ID of an Amazon Route 53 health check" } }, {...} ] } ``` **Sintaxis del alias de conmutación por error**: ``` { "Comment": "optional comment about the changes in this change batch request", "Changes": [ { "Action": "CREATE"|"DELETE"|"UPSERT", "ResourceRecordSet": { "Name": "DNS domain name", "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA", "SetIdentifier": "unique description for this resource record set", "Failover": "PRIMARY" | "SECONDARY", "AliasTarget": { "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone", "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone", "EvaluateTargetHealth": true|false }, "HealthCheckId": "optional ID of an Amazon Route 53 health check" } }, {...} ] } ``` + Para obtener más información sobre la API, consulte [ChangeResourceRecordSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/change-resource-record-sets.html)la *Referencia de AWS CLI comandos*. ### `change-tags-for-resource` En el siguiente ejemplo de código, se muestra cómo utilizar `change-tags-for-resource`. **AWS CLI** El siguiente comando agrega una etiqueta denominada `owner` a un recurso de verificación de estado identificado con el ID: ``` aws route53 change-tags-for-resource --resource-type healthcheck --resource-id 6233434j-18c1-34433-ba8e-3443434 --add-tags Key=owner,Value=myboss ``` El siguiente comando elimina una etiqueta denominada `owner` de un recurso de zona alojada identificada con el ID: ``` aws route53 change-tags-for-resource --resource-type hostedzone --resource-id Z1523434445 --remove-tag-keys owner ``` + Para obtener más información sobre la API, consulte [ChangeTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/change-tags-for-resource.html)la *Referencia de AWS CLI comandos*. ### `create-health-check` En el siguiente ejemplo de código, se muestra cómo utilizar `create-health-check`. **AWS CLI** **Para crear una comprobación de estado** El siguiente comando `create-health-check` crea una comprobación de estado con la referencia de la persona que llama `2014-04-01-18:47` y la configuración con formato JSON del archivo `C:\awscli\route53\create-health-check.json`: ``` aws route53 create-health-check --caller-reference 2014-04-01-18:47 --health-check-config file://C:\awscli\route53\create-health-check.json ``` Sintaxis de JSON: ``` { "IPAddress": "IP address of the endpoint to check", "Port": port on the endpoint to check--required when Type is "TCP", "Type": "HTTP"|"HTTPS"|"HTTP_STR_MATCH"|"HTTPS_STR_MATCH"|"TCP", "ResourcePath": "path of the file that you want Amazon Route 53 to request--all Types except TCP", "FullyQualifiedDomainName": "domain name of the endpoint to check--all Types except TCP", "SearchString": "if Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string to search for in the response body from the specified resource", "RequestInterval": 10 | 30, "FailureThreshold": integer between 1 and 10 } ``` Para añadir la comprobación de estado a un conjunto de registros de recursos de Route 53, utilice el comando `change-resource-record-sets`. Para obtener más información, consulte Amazon Route 53 Health Checks and DNS Failover en la *Guía para desarrolladores de Amazon Route 53*. + Para obtener más información sobre la API, consulte [CreateHealthCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/create-health-check.html)la *Referencia de AWS CLI comandos*. ### `create-hosted-zone` En el siguiente ejemplo de código, se muestra cómo utilizar `create-hosted-zone`. **AWS CLI** **Para crear una zona alojada** El siguiente comando `create-hosted-zone` agrega una zona alojada denominada `example.com` mediante la referencia de intermediario `2014-04-01-18:47`. El comentario opcional incluye un espacio, por lo que debe escribirse entre comillas: ``` aws route53 create-hosted-zone --name example.com --caller-reference 2014-04-01-18:47 --hosted-zone-config Comment="command-line version" ``` Para obtener más información, consulte Working with Hosted Zones en la *Guía para desarrolladores de Amazon Route 53*. + Para obtener más información sobre la API, consulte [CreateHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/create-hosted-zone.html)la *Referencia de AWS CLI comandos*. ### `delete-health-check` En el siguiente ejemplo de código, se muestra cómo utilizar `delete-health-check`. **AWS CLI** **Para eliminar una comprobación de estado** El siguiente comando `delete-health-check` elimina la comprobación de estado con el `health-check-id` `e75b48d9-547a-4c3d-88a5-ae4002397608`: ``` aws route53 delete-health-check --health-check-id e75b48d9-547a-4c3d-88a5-ae4002397608 ``` + Para obtener más información sobre la API, consulte [DeleteHealthCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/delete-health-check.html)la *Referencia de AWS CLI comandos*. ### `delete-hosted-zone` En el siguiente ejemplo de código, se muestra cómo utilizar `delete-hosted-zone`. **AWS CLI** **Para eliminar una zona alojada** El siguiente comando `delete-hosted-zone` elimina la zona alojada con el `id` `Z36KTIQEXAMPLE`: ``` aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE ``` + Para obtener más información sobre la API, consulte [DeleteHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/delete-hosted-zone.html)la *Referencia de AWS CLI comandos*. ### `get-change` En el siguiente ejemplo de código, se muestra cómo utilizar `get-change`. **AWS CLI** **Para obtener el estado de un cambio en los conjuntos de registros de recursos** El siguiente comando `get-change` obtiene el estado y otra información de la solicitud `change-resource-record-sets` que tiene el `Id` `/change/CWPIK4URU2I5S`: ``` aws route53 get-change --id /change/CWPIK4URU2I5S ``` + Para obtener más información sobre la API, consulte [GetChange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/get-change.html)la *Referencia de AWS CLI comandos*. ### `get-health-check` En el siguiente ejemplo de código, se muestra cómo utilizar `get-health-check`. **AWS CLI** **Para obtener información acerca de una comprobación de estado** El siguiente `get-health-check` comando obtiene información sobre la comprobación de estado que tiene el `health-check-id` `02ec8401-9879-4259-91fa-04e66d094674`: ``` aws route53 get-health-check --health-check-id 02ec8401-9879-4259-91fa-04e66d094674 ``` + Para obtener más información sobre la API, consulte [GetHealthCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/get-health-check.html)la *Referencia de AWS CLI comandos*. ### `get-hosted-zone` En el siguiente ejemplo de código, se muestra cómo utilizar `get-hosted-zone`. **AWS CLI** **Para obtener información acerca de una zona alojada** El siguiente comando `get-hosted-zone` obtiene información sobre la zona alojada con un `id` `Z1R8UBAEXAMPLE`: ``` aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE ``` + Para obtener más información sobre la API, consulte [GetHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/get-hosted-zone.html)la *Referencia de AWS CLI comandos*. ### `list-health-checks` En el siguiente ejemplo de código, se muestra cómo utilizar `list-health-checks`. **AWS CLI** **Para ver una lista de los controles de estado asociados a la AWS cuenta corriente** El siguiente `list-health-checks` comando muestra información detallada sobre las 100 primeras comprobaciones de estado asociadas a la AWS cuenta corriente. : ``` aws route53 list-health-checks ``` Si tiene más de 100 comprobaciones de estado o si desea enumerarlas en grupos de menos de 100, incluya el parámetro `--maxitems`. Por ejemplo, para enumerar las comprobaciones de estado, utilice el siguiente comando: ``` aws route53 list-health-checks --max-items 1 ``` Para ver información sobre la siguiente comprobación de estado, tome el valor de `NextToken` de la respuesta al comando anterior e inclúyalo en el parámetro `--starting-token`, por ejemplo: ``` aws route53 list-health-checks --max-items 1 --starting-token Z3M3LMPEXAMPLE ``` + Para obtener más información sobre la API, consulte [ListHealthChecks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-health-checks.html)la *Referencia de AWS CLI comandos*. ### `list-hosted-zones-by-name` En el siguiente ejemplo de código, se muestra cómo utilizar `list-hosted-zones-by-name`. **AWS CLI** En el siguiente comando se enumeran hasta 100 zonas alojadas ordenadas por nombre de dominio: ``` aws route53 list-hosted-zones-by-name ``` Salida: ``` { "HostedZones": [ { "ResourceRecordSetCount": 2, "CallerReference": "test20150527-2", "Config": { "Comment": "test2", "PrivateZone": false }, "Id": "/hostedzone/Z119WBBTVP5WFX", "Name": "2.example.com." }, { "ResourceRecordSetCount": 2, "CallerReference": "test20150527-1", "Config": { "Comment": "test", "PrivateZone": false }, "Id": "/hostedzone/Z3P5QSUBK4POTI", "Name": "www.example.com." } ], "IsTruncated": false, "MaxItems": "100" } ``` En el siguiente comando se muestran las zonas alojadas ordenadas por nombre, empezando por `www.example.com`: ``` aws route53 list-hosted-zones-by-name --dns-name www.example.com ``` Salida: ``` { "HostedZones": [ { "ResourceRecordSetCount": 2, "CallerReference": "mwunderl20150527-1", "Config": { "Comment": "test", "PrivateZone": false }, "Id": "/hostedzone/Z3P5QSUBK4POTI", "Name": "www.example.com." } ], "DNSName": "www.example.com", "IsTruncated": false, "MaxItems": "100" } ``` + Para obtener más información sobre la API, consulte [ListHostedZonesByName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-hosted-zones-by-name.html)la *Referencia de AWS CLI comandos*. ### `list-hosted-zones` En el siguiente ejemplo de código, se muestra cómo utilizar `list-hosted-zones`. **AWS CLI** **Para ver una lista de las zonas alojadas asociadas a la AWS cuenta corriente** El siguiente `list-hosted-zones` comando muestra información resumida sobre las primeras 100 zonas alojadas asociadas a la AWS cuenta actual. : ``` aws route53 list-hosted-zones ``` Si tiene más de 100 zonas alojadas o si desea enumerarlas en grupos de menos de 100, incluya el parámetro `--max-items`. Por ejemplo, para enumerar las zonas alojadas, utilice el siguiente comando: ``` aws route53 list-hosted-zones --max-items 1 ``` Para ver información sobre la siguiente zona alojada, tome el valor de `NextToken` de la respuesta al comando anterior e inclúyalo en el parámetro `--starting-token`, por ejemplo: ``` aws route53 list-hosted-zones --max-items 1 --starting-token Z3M3LMPEXAMPLE ``` + Para obtener más información sobre la API, consulte [ListHostedZones](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-hosted-zones.html)la *Referencia de AWS CLI comandos*. ### `list-query-logging-configs` En el siguiente ejemplo de código, se muestra cómo utilizar `list-query-logging-configs`. **AWS CLI** **Para enumerar las configuraciones de registro de consultas** En el siguiente `list-query-logging-configs` ejemplo, se muestra información sobre las 100 primeras configuraciones de registro de consultas de su AWS cuenta, para la zona alojada`Z1OX3WQEXAMPLE`. ``` aws route53 list-query-logging-configs \ --hosted-zone-id Z1OX3WQEXAMPLE ``` Salida: ``` { "QueryLoggingConfigs": [ { "Id": "964ff34e-ae03-4f06-80a2-9683cexample", "HostedZoneId": "Z1OX3WQEXAMPLE", "CloudWatchLogsLogGroupArn": "arn:aws:logs:us-east-1:111122223333:log-group:/aws/route53/example.com:*" } ] } ``` Para obtener más información, consulte [Logging DNS queries](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html) en la *Guía para desarrolladores de Amazon Route 53*. + Para obtener más información sobre la API, consulta [ListQueryLoggingConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-query-logging-configs.html)la *Referencia de AWS CLI comandos*. ### `list-resource-record-sets` En el siguiente ejemplo de código, se muestra cómo utilizar `list-resource-record-sets`. **AWS CLI** **Para actualizar los conjuntos de registros de recursos en una zona alojada** El siguiente comando `list-resource-record-sets` muestra información resumida sobre los primeros 100 conjuntos de registros de recursos de una zona alojada específica: ``` aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE ``` Si la zona alojada contiene más de 100 conjuntos de registros de recursos o si desea enumerarlos en grupos de menos de 100, incluya el parámetro `--maxitems`. Por ejemplo, para enumerar los conjuntos de registros de recursos, utilice el siguiente comando: ``` aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1 ``` Para ver información sobre el siguiente conjunto de registros de recursos, tome el valor de `NextToken` de la respuesta al comando anterior e inclúyalo en el parámetro `--starting-token`, por ejemplo: ``` aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1 --starting-token Z3M3LMPEXAMPLE ``` Para ver todos los conjuntos de registros de recursos que tengan un nombre concreto, utilice el parámetro `--query` para filtrarlos. Por ejemplo: ``` aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --query "ResourceRecordSets[?Name == 'example.domain.']" ``` + Para obtener más información sobre la API, consulte [ListResourceRecordSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-resource-record-sets.html)la *Referencia de AWS CLI comandos*.