Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Format des Verkehrspolitikdokuments

Wenn Sie eine Verkehrsrichtlinie programmgesteuert mithilfe der Amazon Route 53-API, eines der AWS SDKs, oder AWS Tools for Windows PowerShell erstellen, geben Sie die AWS CLI Definition der Verkehrsrichtlinie in einem Document Element im JSON-Format an.

Weitere Informationen zu Verkehrsrichtlinien finden Sie unter Verwenden von Traffic Flow zur Weiterleitung von DNS-Verkehr im Amazon Route 53-Entwicklerhandbuch.

Basissyntax

Hier ist die grundlegende Syntax für ein Dokument mit Verkehrsrichtlinien:

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

Die grundlegende Syntax für ein Dokument zur Verkehrspolitik enthält die folgenden Objekte:

Syntax für Endpunktdefinitionen

Hier ist die Syntax für die Endpunktdefinitionen, die Sie in einem Dokument zur Verkehrspolitik angeben:

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

Die Syntax für eine Endpunktdefinition enthält die folgenden Objekte:

Syntax für Regeldefinitionen

Je nach Art der Routing-Richtlinie, die Sie verwenden möchten, gibt es unterschiedliche Syntaxen für die Regeldefinitionen, die Sie in einem Dokument zur Verkehrsrichtlinie angeben: Failover, Geolocation, Geoproximity, Latenz, mehrwertige Antwort oder gewichtet.

Failover-Regeln

Weitere Informationen finden Sie unter Konfiguration von DNS-Failover im Amazon Route 53-Entwicklerhandbuch.

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

Wenn Sie eine Failover-Regel definieren, geben Sie die folgenden Objekte an:

Regeln für die Geolokalisierung

Wenn Sie eine Geolokalisierungsregel hinzufügen, konfigurieren Sie Ihre Verkehrsrichtlinie so, dass Ihr Datenverkehr auf der Grundlage des geografischen Standorts Ihrer Benutzer weitergeleitet wird. Weitere Informationen finden Sie unter Geolocation Routing im Amazon Route 53 Developer Guide.

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

Wenn Sie eine Geolocation-Regel definieren, geben Sie die folgenden Objekte an:

Geoproximity-Regeln

Wenn Sie eine Geoproximity-Regel hinzufügen, konfigurieren Sie Amazon Route 53 so, dass der Verkehr auf der Grundlage des geografischen Standorts Ihrer Ressourcen zu Ihren Ressourcen weitergeleitet wird. Sie können optional auch wählen, ob Sie mehr oder weniger Verkehr an einen bestimmten Endpunkt oder eine bestimmte Regel weiterleiten möchten, indem Sie eine Abweichung angeben. Sie verwenden eine systematische Ausrichtung, um die geografische Region, von der der Verkehr zu einem Endpunkt oder einer Regel geleitet wird, zu vergrößern oder zu verkleinern. Weitere Informationen finden Sie unter Geoproximity Routing im Amazon Route 53 Developer Guide.

Das folgende Beispiel gilt AWSPolicyFormatVersion 2023-05-09 nur für:

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

Das folgende Beispiel ist AWSPolicyFormatVersion 2015-10-01 nur für:

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

Wenn Sie eine Geoproximitätsregel definieren, geben Sie die folgenden Objekte an:

Latenzregeln

Wenn Sie eine Latenzregel hinzufügen, konfigurieren Sie Ihre Verkehrsrichtlinie so, dass Ihr Datenverkehr auf der Grundlage der Latenz (der Zeitverzögerung) zwischen Ihren Benutzern und den AWS Regionen, in denen Sie AWS Ressourcen wie ELB-Load Balancer und Amazon S3 S3-Buckets erstellt haben, weitergeleitet wird. Weitere Informationen finden Sie unter Latency Routing im Amazon Route 53 Developer Guide.

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

Wenn Sie eine Latenzregel definieren, geben Sie die folgenden Objekte an:

Regeln für mehrwertige Antworten

Wenn Sie eine Regel für Antworten mit mehreren Werten hinzufügen, konfigurieren Sie Ihre Verkehrsrichtlinie so, dass der Verkehr ungefähr nach dem Zufallsprinzip an Ihre intakten Ressourcen weitergeleitet wird. Amazon Route 53 beantwortet DNS-Abfragen mit bis zu acht fehlerfreien Einträgen. Wenn Sie acht oder weniger fehlerfreie Datensätze haben, beantwortet Route 53 alle DNS-Abfragen mit allen fehlerfreien Einträgen. Weitere Informationen finden Sie unter MultiValueAnswer.

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

Wenn Sie eine mehrwertige Antwortregel definieren, geben Sie die folgenden Objekte an:

Gewichtete Regeln

Wenn Sie eine gewichtete Regel hinzufügen, konfigurieren Sie Ihre Verkehrsrichtlinie so, dass der Verkehr auf der Grundlage der von Ihnen angegebenen Proportionen weitergeleitet wird. Sie könnten beispielsweise Gewichtungen von 4, 5, 5 und 6 (Summe = 20) angeben. Das Ergebnis ist, dass 4/20ths Ihr Datenverkehr im Durchschnitt zum ersten Endpunkt oder zur ersten Regel, 5/20ths sowohl zum zweiten als auch zum dritten Endpunkt oder zur letzten Regel und zum letzten Endpunkt oder zur letzten Regel weitergeleitet 6/20ths wird. Weitere Informationen finden Sie unter Weighted Routing im Amazon Route 53 Developer Guide.

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

Wenn Sie eine gewichtete Regel definieren, geben Sie die folgenden Objekte an:

Beispiele

Die folgenden Beispiele zeigen, wie Failover-, Geolocation-, Geoproximitäts-, Latenz- und gewichtete Regeln verwendet werden und wie mehrere Regeltypen in derselben Verkehrsrichtlinie verwendet werden.

Beispiel für einen Failover

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

Beispiel für Geolokalisierung

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

Beispiele für Geonähe

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

Beispiel für Latenz

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

Gewichtetes Beispiel

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

Beispiel mit Failover-, Latenz- und Geolocation-Regeln

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