Exemplos do Route 53 usando AWS CLI - AWS Command Line Interface
Ações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Route 53 usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Route 53.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar change-resource-record-sets.

AWS CLI

Para criar, atualizar ou excluir um conjunto de registros de recursos

O change-resource-record-sets comando a seguir cria um conjunto de registros de recursos usando a configuração hosted-zone-id Z1R8UBAEXAMPLE e a JSON formatada no arquivo: 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 obter mais informações, consulte POST ChangeResourceRecordSets na Amazon Route 53 API Reference.

A configuração no JSON arquivo depende do tipo de conjunto de registros de recursos que você deseja criar:

BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Pseudônimo

Sintaxe 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"
          },
          {...}
        ]
      }
    },
    {...}
  ]
}

Sintaxe 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"
      }
    },
    {...}
  ]
}

Sintaxe do 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"
      }
    },
    {...}
  ]
}

Sintaxe ponderada do 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",
        "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"
      }
    },
    {...}
  ]
}

Sintaxe de latência:

{
  "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"
      }
    },
    {...}
  ]
}

Sintaxe do alias de latência:

{
  "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"
      }
    },
    {...}
  ]
}

Sintaxe de failover:

{
  "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"
      }
    },
    {...}
  ]
}

Sintaxe do alias de failover:

{
  "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"
      }
    },
    {...}
  ]
}

O código de exemplo a seguir mostra como usar change-tags-for-resource.

AWS CLI

O comando a seguir adiciona uma tag nomeada owner a um recurso de verificação de integridade especificado por ID:

aws route53 change-tags-for-resource --resource-type healthcheck --resource-id 6233434j-18c1-34433-ba8e-3443434 --add-tags Key=owner,Value=myboss

O comando a seguir remove uma tag nomeada owner de um recurso de zona hospedada especificado por ID:

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

O código de exemplo a seguir mostra como usar create-health-check.

AWS CLI

Para criar uma verificação de saúde

O create-health-check comando a seguir cria uma verificação de integridade usando a referência do chamador 2014-04-01-18:47 e a configuração JSON -formatada no arquivo: 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

JSONsintaxe:

{
  "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 adicionar a verificação de saúde a um conjunto de registros de recursos do Route 53, use o change-resource-record-sets comando.

Para obter mais informações, consulte Amazon Route 53 Health Checks and DNS Failover no Amazon Route 53 Developer Guide.

  • Para API obter detalhes, consulte CreateHealthCheckna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-hosted-zone.

AWS CLI

Para criar uma hosted zone

O create-hosted-zone comando a seguir adiciona uma zona hospedada chamada example.com usando a referência 2014-04-01-18:47 do chamador. O comentário opcional inclui um espaço, portanto, ele deve estar entre aspas:

aws route53 create-hosted-zone --name example.com --caller-reference 2014-04-01-18:47 --hosted-zone-config Comment="command-line version"

Para obter mais informações, consulte Como trabalhar com zonas hospedadas no Guia do desenvolvedor do Amazon Route 53.

  • Para API obter detalhes, consulte CreateHostedZonena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-health-check.

AWS CLI

Para excluir uma verificação de saúde

O delete-health-check comando a seguir exclui a verificação de saúde com um health-check-id dee75b48d9-547a-4c3d-88a5-ae4002397608:

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

  • Para API obter detalhes, consulte DeleteHealthCheckna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-hosted-zone.

AWS CLI

Para excluir uma zona hospedada

O delete-hosted-zone comando a seguir exclui a zona hospedada com um id deZ36KTIQEXAMPLE:

aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

  • Para API obter detalhes, consulte DeleteHostedZonena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-change.

AWS CLI

Para obter o status de uma alteração nos conjuntos de registros de recursos

O get-change comando a seguir obtém o status e outras informações sobre a change-resource-record-sets solicitação que tem um Id de/change/CWPIK4URU2I5S:

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

  • Para API obter detalhes, consulte GetChangena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-health-check.

AWS CLI

Para obter informações sobre uma verificação de saúde

O get-health-check comando a seguir obtém informações sobre a verificação de saúde que tem um health-check-id de02ec8401-9879-4259-91fa-04e66d094674:

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

  • Para API obter detalhes, consulte GetHealthCheckna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-hosted-zone.

AWS CLI

Para obter informações sobre uma zona hospedada

O get-hosted-zone comando a seguir obtém informações sobre a zona hospedada com um id dosZ1R8UBAEXAMPLE:

aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

  • Para API obter detalhes, consulte GetHostedZonena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-health-checks.

AWS CLI

Para listar as verificações de saúde associadas à AWS conta atual

O list-health-checks comando a seguir lista informações detalhadas sobre as primeiras 100 verificações de saúde associadas à AWS conta atual. :

aws route53 list-health-checks

Se você tiver mais de 100 verificações de saúde ou quiser listá-las em grupos menores que 100, inclua o --maxitems parâmetro. Por exemplo, para listar as verificações de saúde uma por vez, use o seguinte comando:

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

Para ver a próxima verificação de saúde, pegue o valor NextToken de da resposta ao comando anterior e inclua-o no --starting-token parâmetro, por exemplo:

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

  • Para API obter detalhes, consulte ListHealthChecksna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-hosted-zones-by-name.

AWS CLI

O comando a seguir lista até 100 zonas hospedadas ordenadas por nome de domínio:

aws route53 list-hosted-zones-by-name

Saída:

{
  "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"
}

O comando a seguir lista as zonas hospedadas ordenadas por nome, começando comwww.example.com:

aws route53 list-hosted-zones-by-name --dns-name www.example.com

Saída:

{
  "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"
}

O código de exemplo a seguir mostra como usar list-hosted-zones.

AWS CLI

Para listar as zonas hospedadas associadas à AWS conta atual

O list-hosted-zones comando a seguir lista informações resumidas sobre as primeiras 100 zonas hospedadas associadas à AWS conta atual. :

aws route53 list-hosted-zones

Se você tiver mais de 100 zonas hospedadas ou se quiser listá-las em grupos de menos de 100 zonas, inclua o parâmetro --max-items. Por exemplo, para listar as zonas hospedadas, use o seguinte comando:

aws route53 list-hosted-zones --max-items 1

Para visualizar informações sobre a próxima zona hospedada, pegue o valor de NextToken da resposta ao comando anterior e inclua-o no parâmetro --starting-token, por exemplo:

aws route53 list-hosted-zones --max-items 1 --starting-token Z3M3LMPEXAMPLE

  • Para API obter detalhes, consulte ListHostedZonesna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-query-logging-configs.

AWS CLI

Para listar as configurações de registro de consultas

O list-query-logging-configs exemplo a seguir lista informações sobre as primeiras 100 configurações de registro de consultas em sua AWS conta, para a zona Z1OX3WQEXAMPLE hospedada.

aws route53 list-query-logging-configs \
    --hosted-zone-id Z1OX3WQEXAMPLE

Saída:

{
    "QueryLoggingConfigs": [
        {
            "Id": "964ff34e-ae03-4f06-80a2-9683cexample",
            "HostedZoneId": "Z1OX3WQEXAMPLE",
            "CloudWatchLogsLogGroupArn": "arn:aws:logs:us-east-1:111122223333:log-group:/aws/route53/example.com:*"
        }
    ]
}

Para obter mais informações, consulte Registrar DNS consultas no Amazon Route 53 Developer Guide.

O código de exemplo a seguir mostra como usar list-resource-record-sets.

AWS CLI

Para listar os conjuntos de registros de recursos em uma zona hospedada

O list-resource-record-sets comando a seguir lista informações resumidas sobre os primeiros 100 conjuntos de registros de recursos em uma zona hospedada especificada. :

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE

Se a zona hospedada contiver mais de 100 conjuntos de registros de recursos ou se você quiser listá-los em grupos menores que 100, inclua o --maxitems parâmetro. Por exemplo, para listar conjuntos de registros de recursos um por vez, use o seguinte comando:

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

Para visualizar informações sobre o próximo conjunto de registros de recursos na zona hospedada, use o valor NextToken da resposta ao comando anterior e inclua-o no --starting-token parâmetro, por exemplo:

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

Para visualizar todos os conjuntos de registros de recursos de um nome específico, use o --query parâmetro para filtrá-los. Por exemplo:

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