を使用した Route 53 の例 AWS CLI

次のコード例は、Route 53 AWS Command Line Interface でを使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

アクション

次の例は、change-resource-record-sets を使用する方法を説明しています。

AWS CLI

リソースレコードセットを作成、更新、または削除するには

次のchange-resource-record-setsコマンドは、ファイルの hosted-zone-idZ1R8UBAEXAMPLEおよび JSON形式の設定を使用してリソースレコードセットを作成します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

詳細については、Amazon Route 53APIリファレンスPOST ChangeResourceRecordSets 」の「」を参照してください。

JSON ファイルの設定は、作成するリソースレコードセットの種類によって異なります。

BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover エイリアス

基本構文：


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

加重構文：


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

エイリアス構文：


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

加重エイリアス構文：


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

レイテンシー構文：


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

レイテンシーエイリアス構文：


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

フェイルオーバー構文：


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

フェイルオーバーエイリアス構文：


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

API 詳細については、AWS CLI 「コマンドリファレンスChangeResourceRecordSets」の「」を参照してください。

次の例は、change-tags-for-resource を使用する方法を説明しています。

AWS CLI

次のコマンドは、ID で指定されたヘルスチェックリソースownerにというタグを追加します。


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

次のコマンドは、ID で指定されたホストゾーンリソースownerからというタグを削除します。


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

API 詳細については、AWS CLI 「コマンドリファレンスChangeTagsForResource」の「」を参照してください。

次の例は、create-health-check を使用する方法を説明しています。

AWS CLI

ヘルスチェックを作成するには

次のcreate-health-checkコマンドは、発信者リファレンス2014-04-01-18:47と JSON形式の設定を使用して、ファイルでヘルスチェックを作成します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

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
}

Route 53 リソースレコードセットにヘルスチェックを追加するには、 change-resource-record-sets コマンドを使用します。

詳細については、Amazon Route 53 DNS デベロッパーガイド」のAmazon Route 53ヘルスチェックとフェイルオーバー」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスCreateHealthCheck」の「」を参照してください。

次の例は、create-hosted-zone を使用する方法を説明しています。

AWS CLI

ホストゾーンを作成するには

次のcreate-hosted-zoneコマンドは、発信者リファレンス example.comを使用してという名前のホストゾーンを追加します2014-04-01-18:47。オプションのコメントにはスペースが含まれているため、引用符で囲む必要があります。


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

詳細については、Amazon Route 53デベロッパーガイド」の「ホストゾーンの使用」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスCreateHostedZone」の「」を参照してください。

次のコード例は、delete-health-check を使用する方法を示しています。

AWS CLI

ヘルスチェックを削除するには

次のdelete-health-checkコマンドは、 health-check-id のを使用してヘルスチェックを削除しますe75b48d9-547a-4c3d-88a5-ae4002397608。


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

API 詳細については、AWS CLI 「コマンドリファレンスDeleteHealthCheck」の「」を参照してください。

次の例は、delete-hosted-zone を使用する方法を説明しています。

AWS CLI

ホストゾーンを削除するには

次のdelete-hosted-zoneコマンドは、 idのを持つホストゾーンを削除しますZ36KTIQEXAMPLE。


aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

API 詳細については、AWS CLI 「コマンドリファレンスDeleteHostedZone」の「」を参照してください。

次のコード例は、get-change を使用する方法を示しています。

AWS CLI

リソースレコードセットの変更のステータスを取得するには

次のget-changeコマンドは、 Idのを持つchange-resource-record-setsリクエストのステータスとその他の情報を取得します/change/CWPIK4URU2I5S。


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

API 詳細については、AWS CLI 「コマンドリファレンスGetChange」の「」を参照してください。

次のコード例は、get-health-check を使用する方法を示しています。

AWS CLI

ヘルスチェックに関する情報を取得するには

次のget-health-checkコマンドは、 health-check-id のを持つヘルスチェックに関する情報を取得します02ec8401-9879-4259-91fa-04e66d094674。


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

API 詳細については、AWS CLI 「コマンドリファレンスGetHealthCheck」の「」を参照してください。

次の例は、get-hosted-zone を使用する方法を説明しています。

AWS CLI

ホストゾーンに関する情報を取得するには

次のget-hosted-zoneコマンドは、 idのを使用してホストゾーンに関する情報を取得しますZ1R8UBAEXAMPLE。


aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

API 詳細については、AWS CLI 「コマンドリファレンスGetHostedZone」の「」を参照してください。

次の例は、list-health-checks を使用する方法を説明しています。

AWS CLI

現在の AWS アカウントに関連付けられているヘルスチェックを一覧表示するには

次のlist-health-checksコマンドは、現在の AWS アカウントに関連付けられている最初の 100 件のヘルスチェックに関する詳細情報を一覧表示します。


aws route53 list-health-checks

100 を超えるヘルスチェックがある場合、または 100 未満のグループでリストする場合は、 --maxitemsパラメータを含めます。例えば、ヘルスチェックを一度に 1 つずつ一覧表示するには、次のコマンドを使用します。


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

次のヘルスチェックを表示するには、前のコマンドに対するレスポンスNextTokenからの値を取得し、 --starting-tokenパラメータに含めます。例：


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

API 詳細については、AWS CLI 「コマンドリファレンスListHealthChecks」の「」を参照してください。

次の例は、list-hosted-zones-by-name を使用する方法を説明しています。

AWS CLI

次のコマンドは、ドメイン名順に最大 100 のホストゾーンを一覧表示します。


aws route53 list-hosted-zones-by-name

出力:


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

次のコマンドは、で始まる名前順にホストゾーンを一覧表示しますwww.example.com。


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

出力:


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

API 詳細については、AWS CLI 「コマンドリファレンスListHostedZonesByName」の「」を参照してください。

次の例は、list-hosted-zones を使用する方法を説明しています。

AWS CLI

現在の AWS アカウントに関連付けられているホストゾーンを一覧表示するには

次のlist-hosted-zonesコマンドは、現在の AWS アカウントに関連付けられている最初の 100 のホストゾーンの概要情報を一覧表示します。


aws route53 list-hosted-zones

ホストゾーンが 100 個を超える場合や、100 個未満のグループにホストゾーンを一覧表示する場合は、--max-items パラメータを含めてください。例えば、タイムゾーンを一度に一覧表示するには、次のコマンドを使用します。


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

次のホストゾーンに関する情報を表示するには、前のコマンドに対する応答から NextToken の値を取得し、その値を --starting-token パラメーターに含めます。次に例を示します。


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

API 詳細については、AWS CLI 「コマンドリファレンスListHostedZones」の「」を参照してください。

次の例は、list-query-logging-configs を使用する方法を説明しています。

AWS CLI

クエリログ記録設定を一覧表示するには

次のlist-query-logging-configs例は、ホストゾーンの AWS アカウント内の最初の 100 件のクエリログ記録設定に関する情報を示していますZ1OX3WQEXAMPLE。


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

出力:


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

詳細については、「Amazon Route 53 デベロッパーガイド」のDNS「クエリのログ記録」を参照してください。 Amazon Route 53

API 詳細については、AWS CLI 「コマンドリファレンスListQueryLoggingConfigs」の「」を参照してください。

次のコード例は、list-resource-record-sets を使用する方法を示しています。

AWS CLI

ホストゾーンのリソースレコードセットを一覧表示するには

次のlist-resource-record-setsコマンドは、指定されたホストゾーンの最初の 100 個のリソースレコードセットに関する概要情報を一覧表示します。


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

ホストゾーンに 100 を超えるリソースレコードセットが含まれている場合、または 100 未満のグループでリストする場合は、 --maxitemsパラメータを含めます。例えば、リソースレコードセットを一度に 1 つずつ一覧表示するには、次のコマンドを使用します。


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

ホストゾーン内の次のリソースレコードセットに関する情報を表示するには、前のコマンドに対するレスポンスNextTokenからの値を取得し、 --starting-tokenパラメータに含めます。例：


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

特定の名前のすべてのリソースレコードセットを表示するには、 --queryパラメータを使用してフィルタリングします。例:


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

API 詳細については、AWS CLI 「コマンドリファレンスListResourceRecordSets」の「」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS RoboMaker

Route 53 ドメイン登録