Ejemplos de Route 53 usando 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"
      }
    },
    {...}
  ]
}

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 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 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 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 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 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 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 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 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

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

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.']"