Ejemplos de Route 53 usando AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarlochange-resource-record-sets.

AWS CLI

Para crear, actualizar o eliminar un conjunto de registros de recursos

El siguiente change-resource-record-sets comando crea un conjunto de registros de recursos mediante la configuración JSON con formato hosted-zone-id Z1R8UBAEXAMPLE y 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 la APIreferencia de Amazon Route 53.

La configuración del JSON archivo depende del tipo de conjunto de registros de recursos que desee 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"
      }
    },
    {...}
  ]
}

El siguiente ejemplo de código muestra cómo usarlochange-tags-for-resource.

AWS CLI

El siguiente comando agrega una etiqueta con el nombre owner de un recurso de verificación de estado especificado por 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 nombrada owner de un recurso de zona hospedada especificado por el ID:

aws route53 change-tags-for-resource --resource-type hostedzone --resource-id Z1523434445 --remove-tag-keys owner

El siguiente ejemplo de código muestra cómo usarlocreate-health-check.

AWS CLI

Para crear un chequeo de estado

El siguiente create-health-check comando crea una comprobación de estado utilizando la referencia de la persona que llama 2014-04-01-18:47 y la configuración JSON con formato L 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

JSONsintaxis:

{
  "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 change-resource-record-sets comando.

Para obtener más información, consulte Comprobaciones de estado y DNS conmutación por error de Amazon Route 53 en la Guía para desarrolladores de Amazon Route 53.

  • Para API obtener más información, consulte CreateHealthCheckla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-hosted-zone.

AWS CLI

Para crear una zona alojada

El siguiente create-hosted-zone comando agrega una zona hospedada denominada example.com mediante la referencia 2014-04-01-18:47 de la persona que llama. 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 Trabajar con zonas alojadas en la Guía para desarrolladores de Amazon Route 53.

  • Para API obtener más información, consulte CreateHostedZonela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-health-check.

AWS CLI

Para eliminar un chequeo de estado

El siguiente delete-health-check comando elimina la comprobación de estado con un health-check-id dee75b48d9-547a-4c3d-88a5-ae4002397608:

aws route53 delete-health-check --health-check-id e75b48d9-547a-4c3d-88a5-ae4002397608

  • Para API obtener más información, consulte DeleteHealthCheckla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-hosted-zone.

AWS CLI

Para eliminar una zona alojada

El siguiente delete-hosted-zone comando elimina la zona alojada con un id deZ36KTIQEXAMPLE:

aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

  • Para API obtener más información, consulte DeleteHostedZonela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-change.

AWS CLI

Para obtener el estado de un cambio en los conjuntos de registros de recursos

El siguiente get-change comando obtiene el estado y otra información sobre la change-resource-record-sets solicitud que tiene una Id de las /change/CWPIK4URU2I5S siguientes características:

aws route53 get-change --id /change/CWPIK4URU2I5S

  • Para API obtener más información, consulte GetChangela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-health-check.

AWS CLI

Para obtener información sobre un chequeo de estado

El siguiente get-health-check comando obtiene información sobre la comprobación de estado que tiene una health-check-id de las 02ec8401-9879-4259-91fa-04e66d094674 siguientes características:

aws route53 get-health-check --health-check-id 02ec8401-9879-4259-91fa-04e66d094674

  • Para API obtener más información, consulte GetHealthCheckla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-hosted-zone.

AWS CLI

Para obtener información sobre una zona alojada

El siguiente get-hosted-zone comando obtiene información sobre la zona alojada con una id de las siguientes opcionesZ1R8UBAEXAMPLE:

aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

  • Para API obtener más información, consulte GetHostedZonela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-health-checks.

AWS CLI

Para enumerar 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 controles de estado o si quiere incluirlos en grupos de menos de 100, incluya el --maxitems parámetro. Por ejemplo, para enumerar las comprobaciones de estado de una en una, utilice el siguiente comando:

aws route53 list-health-checks --max-items 1

Para ver la siguiente comprobación de estado, tome el valor NextToken de de la respuesta al comando anterior e inclúyalo en el --starting-token parámetro, por ejemplo:

aws route53 list-health-checks --max-items 1 --starting-token Z3M3LMPEXAMPLE

  • Para API obtener más información, consulte ListHealthChecksla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-hosted-zones-by-name.

AWS CLI

El siguiente comando muestra 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"
}

El siguiente comando muestra las zonas alojadas ordenadas por nombre, empezando porwww.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"
}

El siguiente ejemplo de código muestra cómo usarlolist-hosted-zones.

AWS CLI

Para enumerar las zonas alojadas asociadas a la AWS cuenta actual

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 API obtener más información, consulte ListHostedZonesla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-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 alojadaZ1OX3WQEXAMPLE.

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 Registro de DNS consultas en la Guía para desarrolladores de Amazon Route 53.

El siguiente ejemplo de código muestra cómo usarlolist-resource-record-sets.

AWS CLI

Para enumerar los conjuntos de registros de recursos de una zona alojada

El siguiente list-resource-record-sets comando muestra información resumida sobre los primeros 100 conjuntos de registros de recursos de una zona hospedada 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 --maxitems parámetro. Por ejemplo, para enumerar los conjuntos de registros de recursos de uno en uno, utilice el siguiente comando:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1

Para ver información sobre el siguiente registro de recursos establecido en la zona alojada, tome el valor NextToken de de la respuesta al comando anterior e inclúyalo en el --starting-token parámetro, 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 con un nombre concreto, utilice el --query parámetro para filtrarlos. Por ejemplo:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --query "ResourceRecordSets[?Name == 'example.domain.']"