翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラフィックポリシードキュメントの形式

Amazon Route 53 API、 AWS SDKs の 1 つ、、 AWS CLIまたは を使用してトラフィックポリシーをプログラムで作成する場合は AWS Tools for Windows PowerShell、トラフィックポリシーの定義を JSON 形式の Document要素で指定します。

トラフィックポリシーの詳細については、Amazon Route 53 デベロッパーガイドの「トラフィックフローを使用して DNS トラフィックをルーティングする」を参照してください。

基本構文

トラフィックポリシードキュメントの基本的な構文は次のとおりです。

{
   "AWSPolicyFormatVersion": "2015-10-01 | 2023-05-09",
   "RecordType": "DNS type for all resource record sets created by this traffic policy",
   "StartEndpoint | StartRule": "ID that you assign to an endpoint or rule",
   "Endpoints": {
      "Endpoint ID that you assign": {
         Endpoint definition
      },
      ...
   },
   "Rules": {
      "Rule ID that you assign": {
         Rule definition
      },
      ...
   }
}

トラフィックポリシードキュメントの基本的な構文には、次のオブジェクトが含まれています。

エンドポイント定義の構文

トラフィックポリシードキュメントで指定するエンドポイント定義の構文は次のとおりです。

{
   "Type": value | cloudfront | application-load-balancer | elastic-load-balancer | network-load-balancer | elastic-beanstalk | s3-website,
   "Region": "AWS region that you created your Amazon S3 bucket in"
   "Value": "value applicable to the type of endpoint"
}

エンドポイント定義の構文には、次のオブジェクトが含まれます。

ルール定義の構文

トラフィックポリシードキュメントで指定するルール定義には、使用するルーティングポリシーのタイプに応じて、フェイルオーバー、位置情報、地理的近接性、レイテンシー、複数値の回答、または重み付けなど、さまざまな構文があります。

フェイルオーバールール

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

{
   "RuleType": "failover",
   "Primary": {
      "EndpointReference | RuleReference": "ID that you assigned to the rule or endpoint that this rule routes traffic to",
      "EvaluateTargetHealth": "true" | "false",
      "HealthCheck": "optional health check ID"
   },
   "Secondary": {
      "EndpointReference | RuleReference": "ID that you assigned to the rule or endpoint that this rule routes traffic to",
      "EvaluateTargetHealth": "true" | "false",
      "HealthCheck": "optional health check ID"
   }
}

フェイルオーバールールを定義するときは、次のオブジェクトを指定します。

位置情報ルール

位置情報ルールを追加するときは、ユーザーの地理的位置に基づいてトラフィックをルーティングするようにトラフィックポリシーを設定します。詳細については、「Amazon Route 53 デベロッパーガイド」の「位置情報ルーティング」を参照してください。

{
   "RuleType": "geo",
   "Locations": [
      {
         "EndpointReference | RuleReference": "ID that you assigned to the rule or endpoint that this rule routes traffic to",
         "IsDefault": "true" | "false",
         "Continent": "continent name,
         "Country": "country name,
         "Subdivision": "subdivision name,
         "EvaluateTargetHealth": "true" | "false",
         "HealthCheck": "optional health check ID"
      },
      ...
   ]
}

位置情報ルールを定義するときは、次のオブジェクトを指定します。

地理的近接性ルール

地理的近接性ルールを追加するときは、リソースの地理的位置に基づいてトラフィックをリソースにルーティングするように Amazon Route 53 を設定します。オプションで、バイアスを指定して、特定のエンドポイントまたはルールにより多くのトラフィックをルーティングするか、より少ないトラフィックをルーティングするかを選択することもできます。バイアスを使用して、トラフィックがエンドポイントまたはルールにルーティングされる地理的リージョンのサイズを拡大または縮小します。詳細については、「Amazon Route 53 デベロッパーガイド」の「地理的近接性ルーティング」を参照してください。

次の例は AWSPolicyFormatVersion 2023-05-09専用です。

{
   "RuleType": "geoproximity",
   "GeoproximityLocations": [
      { 
         "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
         "Location":{
            "Type": "Region | LocalZone",
            "LocationName": "AWS Region | AWS Local Zone"
         },
         "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
         "EvaluateTargetHealth": "true | false",
         "HealthCheck": "optional health check ID"
      },
      {
         "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
         "Location":{
            "Type": "Coordinate",
            "Latitude": "location south (negative) or north (positive) of the equator, -90 to 90 degrees",
            "Longitude": "location west (negative) or east (positive) of the prime meridian, -180 to 180 degrees"
         },
         "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
         "EvaluateTargetHealth": "true | false",
         "HealthCheck": "optional health check ID"
      }
   ]
}

次の例は AWSPolicyFormatVersion 2015-10-01専用です。

{
   "RuleType": "geoproximity",
   "GeoproximityLocations": [
      {
         "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
         "Region": "AWS Region",
         "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
         "EvaluateTargetHealth": "true | false",
         "HealthCheck": "optional health check ID"
      },
      {
         "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
         "Latitude": "location south (negative) or north (positive) of the equator, -90 to 90 degrees",
         "Longitude": "location west (negative) or east (positive) of the prime meridian, -180 to 180 degrees",
         "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
         "EvaluateTargetHealth": "true | false",
         "HealthCheck": "optional health check ID"
      }
   ]
}

地理的近接性ルールを定義するときは、次のオブジェクトを指定します。

レイテンシールール

レイテンシールールを追加するときは、ユーザーと、ELB ロードバランサーや Amazon S3 バケットなどの AWS リソースを作成した AWS リージョン間のレイテンシー (遅延時間) に基づいてトラフィックをルーティングするようにトラフィックポリシーを設定します。詳細については、「Amazon Route 53 デベロッパーガイド」の「レイテンシールーティング」を参照してください。

{
   "RuleType": "latency",
   "Regions": [
      {
         "EndpointReference | RuleReference": "ID that you assigned to the rule or endpoint that this rule routes traffic to",
         "Region": "AWS region that you want to route traffic to",
         "EvaluateTargetHealth": "true" | "false",
         "HealthCheck": "optional health check ID"
      },
      ...
   ]
}

レイテンシールールを定義するときは、次のオブジェクトを指定します。

複数値回答ルール

複数値回答ルールを追加するときは、トラフィックポリシーを設定して、トラフィックを正常なリソースにほぼランダムにルーティングします。Amazon Route 53 は最大 8 つの正常なレコードで DNS クエリに応答します。8 つ以下の正常なレコードがある場合、Route 53 はすべての正常なレコードですべての DNS クエリに応答します。詳細については、「MultiValueAnswer」を参照してください。

{
   "RuleType": "multivalue",
   "Items": [
      {
         "EndpointReference": "ID that you assigned to the endpoint that this rule routes traffic to",
         "HealthCheck": "optional health check ID"
      },
      ...
   ]
}

複数値の回答ルールを定義するときは、次のオブジェクトを指定します。

加重ルール

加重ルールを追加するときは、指定した比率に基づいてトラフィックをルーティングするようにトラフィックポリシーを設定します。たとえば、重みとして 4、5、5、6 (合計 = 20) を指定できます。その結果、トラフィックの 4/20 は平均して最初のエンドポイントまたはルールにルーティングされ、5/20 は 2 番目と 3 番目のエンドポイントまたはルールの両方にルーティングされ、6/20 は最後のエンドポイントまたはルールにルーティングされます。詳細については、Amazon Route 53 デベロッパーガイドの加重ルーティングを参照してください。

{
   "RuleType": "weighted",
   "Items": [
      {
         "EndpointReference | RuleReference": "ID that you assigned to the rule or endpoint that this rule routes traffic to",
         "Weight": "value between 0 and 255",
         "EvaluateTargetHealth": "true" | "false",
         "HealthCheck": "optional health check ID"
      },
      ...
   ]
}

加重ルールを定義するときは、次のオブジェクトを指定します。

例

次の例は、フェイルオーバー、位置情報、地理的近接性、レイテンシー、加重ルールの使用方法と、同じトラフィックポリシーで複数のタイプのルールを使用する方法を示しています。

フェイルオーバーの例

{
   "AWSPolicyFormatVersion":"2015-10-01",
   "RecordType":"A",
   "StartRule":"site_switch",
   "Endpoints":{
      "my_elb":{
         "Type":"elastic-load-balancer",
         "Value":"elb-111111.us-east-1.elb.amazonaws.com"
      },
      "site_down_banner":{
         "Type":"s3-website",
         "Region":"us-east-1",
         "Value":"www.example.com"
      }
   },
   "Rules":{
      "site_switch":{
         "RuleType":"failover",
         "Primary":{
            "EndpointReference":"my_elb"
         },
         "Secondary":{
            "EndpointReference":"site_down_banner"
         }
      }
   }
}

位置情報の例

{
  "AWSPolicyFormatVersion":"2015-10-01",
  "RecordType":"A",
  "StartRule":"geo_dest",
  "Endpoints":{
    "english":{
      "Type":"value",
      "Value":"192.0.2.1"
    },
    "french":{
      "Type":"value",
      "Value":"192.0.2.2"
    },
    "german":{
      "Type":"value",
      "Value":"192.0.2.3"
    }
  },
  "Rules":{
    "geo_dest":{
      "RuleType":"geo",
      "Locations":[
        {
          "EndpointReference":"english",
          "Country":"*",
          "HealthCheck":"11111111-1111-1111-1111-111111111111"
        },
        {
          "EndpointReference":"french",
          "Country":"FR",
          "IsDefault":false,
          "HealthCheck":"22222222-2222-2222-2222-222222222222"
        },
        {
          "EndpointReference":"french",
          "Country":"BE",
          "IsDefault":false,
          "HealthCheck":"22222222-2222-2222-2222-222222222222"
        },
        {
          "EndpointReference":"german",
          "Country":"DE",
          "IsDefault":false,
          "HealthCheck":"33333333-3333-3333-3333-333333333333"
        }
      ]
    }
  }
}

地理的近接性の例

{
  "AWSPolicyFormatVersion":"2015-10-01",
  "RecordType":"A",
  "StartRule":"geoprox-rule",
  "Endpoints":{
    "aws-us-west-1-region":{
      "Type":"elastic-load-balancer",
      "Value":"elb-123456.us-east-1.elb.amazonaws.com"
    },
    "london-data-center":{
      "Type":"value",
      "Value":"192.0.2.1"
    }
  },
  "Rules":{
    "geoprox-rule":{
      "RuleType": "geoproximity",
      "GeoproximityLocations": [
        {
          "EndpointReference": "aws-us-west-1-region",
          "Region": "aws:route53:us-west-1",
          "Bias": "10",
          "HealthCheck": "11111111-1111-1111-1111-111111111111"
        },
        {
          "EndpointReference": "london-data-center",
          "Latitude": "51.50",
          "Longitude": "-0.16",
          "Bias": "0",
          "HealthCheck": "22222222-2222-2222-2222-222222222222"
        }
      ]
    }
  }
}

{
  "AWSPolicyFormatVersion":"2023-05-09",
  "RecordType":"A",
  "StartRule":"geoprox-rule",
  "Endpoints":{
    "aws-us-west-1-region":{
      "Type":"elastic-load-balancer",
      "Value":"elb-123456.us-west-1.elb.amazonaws.com"
    },
    "aws-us-east-1-atl-local-zone":{
      "Type":"elastic-load-balancer",
      "Value":"elb-123456.us-east-1.elb.amazonaws.com"
    },
    "london-data-center":{
      "Type":"value",
      "Value":"192.0.2.1"
    }
  },
  "Rules":{
    "geoprox-rule":{
      "RuleType": "geoproximity",
      "GeoproximityLocations": [
        {
          "EndpointReference": "aws-us-west-1-region",
          "Location": {
            "Type": "Region",
            "LocationName": "aws:route53:us-west-1"
          },
          "Bias": "-10",
          "HealthCheck": "11111111-1111-1111-1111-111111111111"
        },
        {
          "EndpointReference": "aws-us-east-1-atl-local-zone",
          "Location": {
            "Type": "LocalZone",
            "LocationName": "aws:route53:us-east-1-atl-1a"
          },
          "Bias": "10",
          "HealthCheck": "22222222-2222-2222-2222-222222222222"
        },
        {
          "EndpointReference": "london-data-center",
          "Location": {
            "Type": "Coordinate",
            "Latitude": "51.50",
            "Longitude": "-0.16"
          },
          "Bias": "0",
          "HealthCheck": "33333333-3333-3333-3333-333333333333"
        }
      ]
    }
  }
}

レイテンシーの例

{
  "AWSPolicyFormatVersion":"2015-10-01",
  "RecordType":"A",
  "StartRule":"region_selector",
  "Endpoints":{
    "us_lb":{
      "Type":"elastic-load-balancer",
      "Value":"elb-123456.us-east-1.elb.amazonaws.com"
    },
    "europe_lb":{
      "Type":"elastic-load-balancer",
      "Value":"elb-654321.eu-west-1.elb.amazonaws.com"
    }
  },
  "Rules":{
    "region_selector":{
      "RuleType":"latency",
      "Regions":[
        {
          "Region":"us-east-1",
          "EndpointReference":"us_lb"
        },
        {
          "Region":"eu-west-1",
          "EndpointReference":"europe_lb"
        }
      ]
    }
  }
}

加重例

{
  "AWSPolicyFormatVersion":"2015-10-01",
  "RecordType":"A",
  "StartRule":"round_robin",
  "Endpoints":{
    "srv1":{
      "Type":"value",
      "Value":"192.0.2.1"
    },
    "srv2":{
      "Type":"value",
      "Value":"192.0.2.2"
    },
    "srv3":{
      "Type":"value",
      "Value":"192.0.2.3"
    }
  },
  "Rules":{
    "round_robin":{
      "RuleType":"weighted",
      "Items":[
        {
          "EndpointReference":"srv1",
          "Weight":"3",
          "HealthCheck":"11111111-1111-1111-1111-111111111111"
        },
        {
          "EndpointReference":"srv2",
          "Weight":"1",
          "HealthCheck":"22222222-2222-2222-2222-222222222222"
        },
        {
          "EndpointReference":"srv3",
          "Weight":"1",
          "HealthCheck":"33333333-3333-3333-3333-333333333333"
        }
      ]
    }
  }
}

フェイルオーバー、レイテンシー、位置情報ルールの例

{
  "AWSPolicyFormatVersion":"2015-10-01",
  "RecordType":"A",
  "StartRule":"geo_restriction",
  "Endpoints":{
    "east_coast_lb1":{
      "Type":"elastic-load-balancer",
      "Value":"elb-111111.us-east-1.elb.amazonaws.com"
    },
    "east_coast_lb2":{
      "Type":"elastic-load-balancer",
      "Value":"elb-222222.us-east-1.elb.amazonaws.com"
    },
    "west_coast_lb1":{
      "Type":"elastic-load-balancer",
      "Value":"elb-111111.us-west-1.elb.amazonaws.com"
    },
    "west_coast_lb2":{
      "Type":"elastic-load-balancer",
      "Value":"elb-222222.us-west-1.elb.amazonaws.com"
    },
    "denied_message":{
      "Type":"s3-website",
      "Region":"us-east-1",
      "Value":"video.example.com"
    }
  },
  "Rules":{
    "geo_restriction":{
      "RuleType":"geo",
      "Locations":[
        {
          "EndpointReference":"denied_message",
          "IsDefault":true
        },
        {
          "RuleReference":"region_selector",
          "Country":"US"
        }
      ]
    },
    "region_selector":{
      "RuleType":"latency",
      "Regions":[
        {
          "Region":"us-east-1",
          "RuleReference":"east_coast_region"
        },
        {
          "Region":"us-west-1",
          "RuleReference":"west_coast_region"
        }
      ]
    },
    "east_coast_region":{
      "RuleType":"failover",
      "Primary":{
        "EndpointReference":"east_coast_lb1"
      },
      "Secondary":{
        "EndpointReference":"east_coast_lb2"
      }
    },
    "west_coast_region":{
      "RuleType":"failover",
      "Primary":{
        "EndpointReference":"west_coast_lb1"
      },
      "Secondary":{
        "EndpointReference":"west_coast_lb2"
      }
    }
  }
}