Exemples de Route 53 utilisant AWS CLI

Pour créer, mettre à jour ou supprimer un jeu d’enregistrements de ressources

La commande change-resource-record-sets suivante crée un jeu d’enregistrements de ressources à l’aide de l’hosted-zone-id Z1R8UBAEXAMPLE et de la configuration au format JSON du fichier 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

Pour plus d'informations, consultez POST ChangeResourceRecordSets dans le manuel Amazon Route 53 API Reference.

La configuration du fichier JSON dépend du type de jeu d’enregistrements de ressources que vous souhaitez créer :

BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Alias

Syntaxe de base :

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

Syntaxe pondérée :

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

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

Syntaxe d’alias pondérée :

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

Syntaxe de latence :

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

Syntaxe d’alias de latence :

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

Syntaxe de basculement :

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

Syntaxe d’alias de basculement :

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

La commande suivante ajoute une balise nommée owner à une ressource de surveillance de l’état spécifiée par ID :

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

La commande suivante supprime une balise nommée owner à partir d’une ressource de zone hébergée spécifiée par ID :

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

Pour créer une surveillance de l’état

La commande create-health-check suivante crée une surveillance de l’état à l’aide de la référence appelant 2014-04-01-18:47 et de la configuration au format JSON du fichier 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

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

Pour ajouter la surveillance de l’état à un jeu d’enregistrements de ressources Route 53, utilisez la commande change-resource-record-sets.

Pour plus d’informations, consultez Surveillances de l’état Amazon Route 53 et basculement DNS dans le Manuel du développeur Amazon Route 53.

Pour créer une zone hébergée

La commande create-hosted-zone suivante ajoute une zone hébergée nommée example.com à l’aide de la référence appelant 2014-04-01-18:47. Le commentaire facultatif inclut un espace, il doit donc être placé entre guillemets :

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

Pour plus d’informations, consultez Utilisation de zones hébergées dans le Guide du développeur Amazon Route 53.

Pour supprimer une surveillance de l’état

La commande delete-health-check suivante supprime la surveillance de l’état avec l’health-check-id e75b48d9-547a-4c3d-88a5-ae4002397608 :

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

Pour supprimer une zone hébergée

La commande delete-hosted-zone suivante supprime la zone hébergée avec l’id Z36KTIQEXAMPLE :

aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

Pour obtenir le statut d’une modification apportée aux jeux d’enregistrements de ressources

La commande get-change suivante obtient le statut et d’autres informations relatives à la demande change-resource-record-sets qui a l’Id /change/CWPIK4URU2I5S :

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

Pour obtenir les informations sur une surveillance de l’état

La commande get-health-check suivante obtient des informations sur la surveillance de l’état qui a l’health-check-id 02ec8401-9879-4259-91fa-04e66d094674 :

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

Pour obtenir les informations sur une zone hébergée

La commande get-hosted-zone suivante obtient des informations sur la zone hébergée qui a l’id Z1R8UBAEXAMPLE :

aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

Pour répertorier les bilans de santé associés au AWS compte courant

La list-health-checks commande suivante répertorie des informations détaillées sur les 100 premiers bilans de santé associés au AWS compte courant. :

aws route53 list-health-checks

Si vous avez plus de 100 surveillances de l’état ou si vous souhaitez les répertorier dans des groupes inférieurs à 100 éléments, incluez le paramètre --maxitems. Par exemple, pour répertorier les surveillances de l’état une par une, utilisez la commande suivante :

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

Pour afficher la surveillance de l’état suivante, prenez la valeur NextToken de la réponse à la commande précédente et incluez-la dans le paramètre --starting-token, par exemple :

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

La commande suivante crée une liste de 100 zones hébergées maximum, classées par nom de domaine :

aws route53 list-hosted-zones-by-name

Sortie :

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

La commande suivante crée une liste des zones hébergées classées par nom, commençant par www.example.com :

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

Sortie :

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

Pour répertorier les zones hébergées associées au AWS compte actuel

La list-hosted-zones commande suivante répertorie les informations récapitulatives sur les 100 premières zones hébergées associées au AWS compte actuel. :

aws route53 list-hosted-zones

Si vous avez plus de 100 zones hébergées ou si vous souhaitez les répertorier dans des groupes inférieurs à 100, incluez le paramètre --max-items. Par exemple, pour répertorier les zones hébergées une par une, utilisez la commande suivante :

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

Pour afficher les informations relatives à la zone hébergée suivante, prenez la valeur NextToken de la réponse à la commande précédente et incluez-la dans le paramètre --starting-token, par exemple :

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

Pour créer une liste des configurations de journalisation de requêtes

L'list-query-logging-configsexemple suivant répertorie les informations relatives aux 100 premières configurations de journalisation des requêtes de votre AWS compte, pour la zone hébergéeZ1OX3WQEXAMPLE.

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

Sortie :

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

Pour plus d’informations, consultez Journalisation des requêtes DNS dans le Guide du développeur Amazon Route 53.

Pour créer une liste des jeux d’enregistrements de ressources d’une zone hébergée

La commande list-resource-record-sets suivante crée une liste des informations récapitulatives sur les 100 premiers jeux d’enregistrements de ressources dans une zone hébergée spécifiée :

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

Si la zone hébergée contient plus de 100 jeux d’enregistrements de ressources ou si vous souhaitez les répertorier dans des groupes inférieurs à 100 éléments, incluez le paramètre --maxitems. Par exemple, pour répertorier les jeux d’enregistrements de ressources un par un, utilisez la commande suivante :

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

Pour afficher les informations relatives au jeu d’enregistrements de ressources suivant de la zone hébergée, prenez la valeur NextToken de la réponse à la commande précédente et incluez-la dans le paramètre --starting-token, par exemple :

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

Pour afficher tous les jeux d’enregistrements de ressources portant un nom particulier, utilisez le paramètre --query afin de les filtrer. Par exemple :

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