Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Format du document de politique de trafic
Lorsque vous créez une politique de trafic par programmation à l'aide de l'API Amazon Route 53, de l'un des AWS SDK, ou AWS CLI AWS Tools for Windows PowerShell, vous spécifiez la définition de la politique de trafic dans un `Document` élément au format JSON.
Pour plus d'informations sur les politiques de trafic, consultez la section [Utiliser le flux de trafic pour acheminer le trafic DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/traffic-flow.html) dans le manuel *Amazon Route 53 Developer Guide*.
**Topics**
+ [Syntaxe de base](#traffic-policy-document-format-basic)
+ [Syntaxe pour les définitions des terminaux](#traffic-policy-document-format-endpoints)
+ [Syntaxe pour les définitions de règles](#traffic-policy-document-format-rules)
+ [Exemples](#traffic-policy-document-format-examples)
## Syntaxe de base
Voici la syntaxe de base d'un document de politique de trafic :
```
1. {
2. "AWSPolicyFormatVersion": "2015-10-01 | 2023-05-09",
3. "RecordType": "{{DNS type for all resource record sets created by this traffic policy}}",
4. "StartEndpoint | StartRule": "{{ID that you assign to an endpoint or rule}}",
5. "Endpoints": {
6. "{{Endpoint ID that you assign}}": {
7. {{Endpoint definition}}
8. },
9. ...
10. },
11. "Rules": {
12. "{{Rule ID that you assign}}": {
13. {{Rule definition}}
14. },
15. ...
16. }
17. }
```
La syntaxe de base d'un document de politique de trafic contient les objets suivants :
**AWSPolicyFormatVersion**
La version du format de politique de trafic, la dernière version compatible avec les Zones AWS Locales ;`2023-05-09`.
La version précédente est également prise en charge ;`2015-10-01`.
**RecordType**
Type DNS de tous les ensembles d'enregistrements de ressources qu'Amazon Route 53 créera sur la base de cette politique de trafic. Si vous souhaitez acheminer le trafic vers les AWS ressources suivantes, choisissez la valeur applicable :
+ **CloudFront distribution** — Choisissez **A : adresse IP au format IPv4** ou **AAAA : adresse IP au format IPv6**.
+ **Équilibreur Application Load Balancer ELB** : choisissez **A : adresse IP au format IPv4** ou **AAAA : adresse IP au format IPv6**.
+ **Équilibreur Classic Load Balancer ELB** : choisissez **A : adresse IP au format IPv4** ou **AAAA : adresse IP au format IPv6**.
+ **Équilibreur Network Load Balancer ELB** : choisissez **A : adresse IP au format IPv4** ou **AAAA : adresse IP au format IPv6**.
+ Environnement **Elastic Beanstalk** **— Choisissez A : adresse IP au format IPv4 ou AAAA : adresse IP** **au format** IPv6.
+ **Amazon S3 bucket configured as a website endpoint (Compartiment Amazon S3 configuré en tant que point de terminaison d'un site web)** : choisissez **A: IP address in IPv4 format (A : Adresse IP au format IPv4)**.
Si vous souhaitez acheminer le trafic vers d'autres ressources, choisissez le type applicable à la ressource. Par exemple, si vous souhaitez acheminer le trafic vers les serveurs de messagerie, spécifiez`MX`. Pour obtenir la liste des types de DNS pris en charge par Route 53, consultez la section [Types d'enregistrements de ressources DNS pris en charge](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html) dans le manuel *Amazon Route 53 Developer Guide*.
**StartEndpoint \| StartRule**
Si vous souhaitez que le point de départ de la politique de trafic soit un point de terminaison ou une règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**Points de terminaison**
Les définitions des points de terminaison que vous souhaitez utiliser dans cette politique de trafic. Pour de plus amples informations, veuillez consulter [Syntaxe pour les définitions des terminaux](#traffic-policy-document-format-endpoints).
**Rules**
Les définitions des règles que vous souhaitez utiliser dans cette politique de trafic. Pour de plus amples informations, veuillez consulter [Syntaxe pour les définitions de règles](#traffic-policy-document-format-rules).
## Syntaxe pour les définitions des terminaux
Voici la syntaxe des définitions de point de terminaison que vous spécifiez dans un document de politique de trafic :
```
1. {
2. "Type": value | cloudfront | application-load-balancer | elastic-load-balancer | network-load-balancer | elastic-beanstalk | s3-website,
3. "Region": "AWS region that you created your Amazon S3 bucket in"
4. "Value": "value applicable to the type of endpoint"
5. }
```
La syntaxe d'une définition de point de terminaison contient les objets suivants :
**Type**
Spécifiez la valeur applicable :
**value**
Pour acheminer le trafic vers une ressource autre que celles de la liste suivante, spécifiez `value` pour`Type`.
**cloudfront**
Pour acheminer le trafic vers une CloudFront distribution, spécifiez `cloudfront` pour`Type`.
**équilibreur de charge des applications**
Pour acheminer le trafic vers un Application Load Balancer, spécifiez `application-load-balancer` pour. `Type`
**équilibreur de charge élastique**
Pour acheminer le trafic vers un équilibreur de charge ELB Classic, spécifiez `elastic-load-balancer` pour. `Type`
**équilibreur de charge réseau**
Pour acheminer le trafic vers un équilibreur de charge réseau ELB, spécifiez `network-load-balancer` pour. `Type`
**haricot élastique**
Pour acheminer le trafic vers un environnement Elastic Beanstalk, spécifiez pour. `elastic-beanstalk` `Type`
**site web S3**
Pour acheminer le trafic vers un compartiment Amazon S3 configuré comme point de terminaison de site Web, spécifiez `s3-website` pour`Type`.
**Région**
Pour acheminer le trafic vers un compartiment Amazon S3 configuré comme point de terminaison de site Web, spécifiez la région pour laquelle vous avez créé le compartiment`Region`. Pour toute autre ressource, omettez`Region`.
**Value**
Spécifiez la valeur applicable :
**value**
Pour acheminer le trafic vers une ressource autre que celles répertoriées ci-dessous, spécifiez la valeur correspondant à la valeur que vous avez spécifiée`RecordType`. Par exemple, si vous avez spécifié `A` pour`RecordType`, spécifiez une adresse IP au format IPv4 pour`Value`.
**cloudfront**
Si vous avez spécifié `cloudfront` pour`Type`, spécifiez le nom de domaine CloudFront attribué à votre CloudFront distribution lorsque vous l'avez créée, par exemple,`d111111abcdef8.cloudfront.net`.
**équilibreur de charge des applications**
Si vous avez spécifié `application-load-balancer` pour`Type`, spécifiez le nom DNS de votre équilibreur de charge. Par exemple, `exampleAlb-1283637735.us-east-1.elb.amazonaws.com`.
**équilibreur de charge élastique**
Si vous avez spécifié `elastic-load-balancer` pour`Type`, spécifiez le nom DNS de votre équilibreur de charge. Utilisez la valeur commençant par`dualstack`, par exemple,`dualstack.my-load-balancer-1234567890.us-west-2.elb.amazonaws.com`.
**équilibreur de charge réseau**
Si vous avez spécifié `network-load-balancer` pour`Type`, spécifiez le nom DNS de votre équilibreur de charge. Par exemple, `exampleNlb-74f87b114e21682a.elb.us-east-1.amazonaws.com`.
**haricot élastique**
Si vous avez spécifié `elastic-beanstalk` pour`Type`, spécifiez le nom de domaine de votre environnement Elastic Beanstalk. Par exemple, `example-beanstalk-env-1.eba-ns4qrife.us-east-1.elasticbeanstalk.com`.
**site web S3**
Si vous avez spécifié `s3-website` pour`Type`, spécifiez le nom de votre compartiment Amazon S3, par exemple,`example.com.s3-website-us-east-1.amazonaws.com`.
Lorsque vous créez une instance de politique de trafic basée sur cette politique de trafic, le bucket que vous spécifiez ici doit correspondre au nom de domaine (tel que www.example.com) que vous spécifiez `Name` dans la [CreateTrafficPolicyInstance](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicyInstance.html)demande. Si `Value` ce `Name` n'est pas le cas, Amazon S3 ne répondra pas aux requêtes DNS relatives au nom de domaine.
## Syntaxe pour les définitions de règles
Il existe différentes syntaxes pour les définitions de règles que vous spécifiez dans un document de politique de trafic, en fonction du type de politique de routage que vous souhaitez utiliser : basculement, géolocalisation, géoproximité, latence, réponse à valeurs multiples ou pondération.
**Topics**
+ [Règles de basculement](#traffic-policy-document-format-rules-failover)
+ [Règles de géolocalisation](#traffic-policy-document-format-rules-geo)
+ [Règles de géoproximité](#traffic-policy-document-format-rules-geoproximity)
+ [Règles de latence](#traffic-policy-document-format-rules-latency)
+ [Règles de réponse à valeurs multiples](#traffic-policy-document-format-rules-multivalue-answer)
+ [Règles pondérées](#traffic-policy-document-format-rules-weighted)
### Règles de basculement
Pour plus d'informations, consultez [la section Configuration du basculement DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring.html) dans le *guide du développeur Amazon Route 53*.
```
1. {
2. "RuleType": "failover",
3. "Primary": {
4. "EndpointReference | RuleReference": "{{ID that you assigned to the rule or endpoint that this rule routes traffic to}}",
5. "EvaluateTargetHealth": "true" | "false",
6. "HealthCheck": "{{optional health check ID}}"
7. },
8. "Secondary": {
9. "EndpointReference | RuleReference": "{{ID that you assigned to the rule or endpoint that this rule routes traffic to}}",
10. "EvaluateTargetHealth": "true" | "false",
11. "HealthCheck": "{{optional health check ID}}"
12. }
13. }
```
Lorsque vous définissez une règle de basculement, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `failover`.
**Primaire \| Secondaire**
Pour l'`Primary`objet, spécifiez les paramètres de la règle ou du point de terminaison vers lequel vous souhaitez acheminer le trafic chaque fois que les ressources correspondantes sont disponibles.
Pour l'`Secondary`objet, spécifiez les paramètres de la règle ou du point de terminaison vers lequel vous souhaitez acheminer le trafic lorsque les ressources principales ne sont pas disponibles.
**EndpointReference \| RuleReference**
Si vous souhaitez acheminer le trafic vers un point de terminaison ou vers une autre règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**EvaluateTargetHealth**
Un booléen qui indique si vous souhaitez qu'Amazon Route 53 évalue l'état du point de terminaison et achemine le trafic uniquement vers des points de terminaison sains. Pour plus d'informations, consultez [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Si vous souhaitez associer un bilan de santé au point de terminaison ou à la règle, spécifiez l'ID du bilan de santé. Pour plus d'informations, consultez [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Règles de géolocalisation
Lorsque vous ajoutez une règle de géolocalisation, vous configurez votre politique de trafic pour acheminer votre trafic en fonction de l'emplacement géographique de vos utilisateurs. Pour plus d'informations, consultez [Geolocation Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo) dans le guide du *développeur Amazon Route 53*.
```
1. {
2. "RuleType": "geo",
3. "Locations": [
4. {
5. "EndpointReference | RuleReference": "{{ID that you assigned to the rule or endpoint that this rule routes traffic to}}",
6. "IsDefault": "true" | "false",
7. "Continent": "{{continent name}},
8. "Country": "{{country name}},
9. "Subdivision": "{{subdivision name}},
10. "EvaluateTargetHealth": "true" | "false",
11. "HealthCheck": "{{optional health check ID}}"
12. },
13. ...
14. ]
15. }
```
Lorsque vous définissez une règle de géolocalisation, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `geo`.
**Emplacements**
Spécifiez un ensemble de valeurs (`EndpointReference`\| `RuleReference``IsDefault`,`Continent`,`Country`,`Subdivision`,`EvaluateTargetHealth`, et`HealthCheck`) pour chacun des emplacements géographiques vers lesquels vous souhaitez acheminer le trafic.
**EndpointReference \| RuleReference**
Si vous souhaitez acheminer le trafic vers un point de terminaison ou vers une autre règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**IsDefault**
Un booléen qui indique si cet ensemble de valeurs représente l'emplacement par défaut. Si vous spécifiez `*` comme valeur de l'`CountryCode`élément dans un emplacement géographique, la valeur de l'`IsDefault`élément pour cet emplacement est définie `True` par défaut et vous ne pouvez pas spécifier `True` comme valeur de l'`IsDefault`élément dans d'autres emplacements géographiques pour la même règle de géolocalisation. Pour plus d'informations sur la définition `*` de la valeur de l'`CountryCode`élément, consultez l'entrée suivante pour`Continent, Country, Subdivision`.
**Continent, pays, subdivision**
Valeurs qui indiquent l'emplacement géographique des utilisateurs dont vous souhaitez acheminer le trafic vers une règle ou un point de terminaison. Pour plus d'informations, consultez les descriptions des éléments suivantes dans la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html):
+ `GeoLocation`
+ `ContinentCode`
+ `CountryCode`
+ `SubdivisionCode`
Pour plus d'informations, consultez la section [Localisation](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-geo.html#rrsets-values-geo-location) dans le guide du développeur *Amazon Route 53*.
La géolocalisation se base sur le mappage d'adresses IP à des emplacements. Cependant, certaines adresses IP ne sont pas mappées à des emplacements géographiques. Ainsi, même si vous créez des emplacements géographiques couvrant les sept continents, Route 53 recevra des requêtes DNS provenant de lieux qu'elle ne peut pas identifier. Nous vous recommandons de créer un emplacement géographique dont la valeur de `Country` est`*`. Deux groupes de requêtes sont acheminés vers la ressource que vous spécifiez dans cet enregistrement : les requêtes provenant d'emplacements pour lesquels vous n'avez pas créé d'emplacements géographiques et les requêtes provenant d'adresses IP qui ne sont pas mappées à un emplacement. Si vous ne créez pas d'emplacement `*` géographique, Route 53 renvoie une réponse « sans réponse » pour les requêtes provenant de lieux non cartographiés.
**EvaluateTargetHealth**
Un booléen qui indique si vous souhaitez qu'Amazon Route 53 évalue l'état du point de terminaison et achemine le trafic uniquement vers des points de terminaison sains. Pour plus d'informations, consultez [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Si vous souhaitez associer un bilan de santé au point de terminaison ou à la règle, spécifiez l'ID du bilan de santé. Pour plus d'informations, consultez [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Règles de géoproximité
Lorsque vous ajoutez une règle de géoproximité, vous configurez Amazon Route 53 pour acheminer le trafic vers vos ressources en fonction de l'emplacement géographique de vos ressources. Vous pouvez également choisir d'acheminer plus ou moins de trafic vers un point de terminaison ou une règle donnée en spécifiant un biais. Vous utilisez un biais pour étendre ou réduire la taille de la région géographique à partir de laquelle le trafic est acheminé vers un point de terminaison ou une règle. Pour plus d'informations, consultez la section [Geoproximity Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geoproximity) dans le *guide du développeur Amazon Route 53*.
L'exemple suivant ne concerne `AWSPolicyFormatVersion 2023-05-09` que :
```
1. {
2. "RuleType": "geoproximity",
3. "GeoproximityLocations": [
4. {
5. "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
6. "Location":{
7. "Type": "Region | LocalZone",
8. "LocationName": "AWS Region | AWS Local Zone"
9. },
10. "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
11. "EvaluateTargetHealth": "true | false",
12. "HealthCheck": "optional health check ID"
13. },
14. {
15. "EndpointReference | RuleReference": "ID that you assigned to the endpoint or rule that this rule routes traffic to",
16. "Location":{
17. "Type": "Coordinate",
18. "Latitude": "location south (negative) or north (positive) of the equator, -90 to 90 degrees",
19. "Longitude": "location west (negative) or east (positive) of the prime meridian, -180 to 180 degrees"
20. },
21. "Bias": "optional value to expand or shrink the geographic region for this rule, -99 to 99",
22. "EvaluateTargetHealth": "true | false",
23. "HealthCheck": "optional health check ID"
24. }
25. ]
26. }
```
L'exemple suivant ne concerne `AWSPolicyFormatVersion 2015-10-01` que :
```
1. {
2. "RuleType": "geoproximity",
3. "GeoproximityLocations": [
4. {
5. "EndpointReference | RuleReference": "{{ID that you assigned to the endpoint or rule that this rule routes traffic to}}",
6. "Region": "{{AWS Region}}",
7. "Bias": "{{optional value to expand or shrink the geographic region for this rule, -99 to 99}}",
8. "EvaluateTargetHealth": "true | false",
9. "HealthCheck": "{{optional health check ID}}"
10. },
11. {
12. "EndpointReference | RuleReference": "{{ID that you assigned to the endpoint or rule that this rule routes traffic to}}",
13. "Latitude": "{{location south (negative) or north (positive) of the equator, -90 to 90 degrees}}",
14. "Longitude": "{{location west (negative) or east (positive) of the prime meridian, -180 to 180 degrees}}",
15. "Bias": "{{optional value to expand or shrink the geographic region for this rule, -99 to 99}}",
16. "EvaluateTargetHealth": "true | false",
17. "HealthCheck": "{{optional health check ID}}"
18. }
19. ]
20. }
```
Lorsque vous définissez une règle de géoproximité, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `geoproximity`.
**GeoproximityLocations**
Spécifiez un ensemble de valeurs pour chaque ressource vers laquelle vous souhaitez acheminer le trafic. Vous pouvez spécifier un champ de **localisation**, qui prend en charge les AWS régions, les zones locales, ainsi que les latitudes et les longitudes en`AWSPolicyFormatVersion 2023-05-09`. Vous pouvez également spécifier une AWS région ou la latitude et la longitude d'un emplacement géographique dans`AWSPolicyFormatVersion 2015-10-01`.
**EndpointReference \| RuleReference**
Si vous souhaitez acheminer le trafic vers un point de terminaison ou vers une autre règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**Emplacement (`AWSPolicyFormatVersion 2023-05-09`uniquement)**
Le champ Emplacement prend en charge AWS les régions, les zones locales, les latitudes et les longitudes au format suivant :
Pour les Zones Locales : `"Location": { "Type": "LocalZone", "LocationName": "aws:route53:us-east-1-atl-1a" }`
Pour les régions : `"Location": { "Type": "Region", "LocationName": "aws:route53:us-east-1" },`
Pour les coordonnées : `"Location": { "Type": "Coordinate", "Latitude": "38.9", "Longitude": "-77.01" },`
Pour obtenir la liste des codes de région valides, consultez [la section Région](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) dans la documentation relative à [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
Pour connaître les zones locales disponibles, consultez la section [Emplacements des zones locales AWS](https://aws.amazon.com/about-aws/global-infrastructure/localzones/locations/).
**Région (`AWSPolicyFormatVersion 2015-10-01`uniquement)**
Si votre point de terminaison est une AWS ressource, spécifiez la AWS région dans laquelle vous avez créé la ressource. Utilisez le format suivant :
`aws:route53:`{{region-code}}
Pour obtenir la liste des codes de région valides, consultez [la section Région](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) dans la documentation relative à [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**Latitude et longitude (`AWSPolicyFormatVersion 2015-10-01`uniquement)**
Si votre point de terminaison n'est pas une AWS ressource, entrez la latitude et la longitude de l'emplacement de la ressource. Notez ce qui suit :
+ La latitude représente la position au sud (valeur négative) ou au nord (valeur positive) de l'équateur. Les valeurs valides vont de -90 degrés à 90 degrés.
+ La longitude représente la position à l'ouest (valeur négative) ou à l'est (valeur positive) du méridien de référence. Les valeurs valides vont de -180 degrés à 180 degrés.
+ Pour connaître la latitude et la longitude, vous pouvez avoir recours à diverses applications de cartographie en ligne. Par exemple, dans Google Maps, l'URL d'un emplacement spécifie la latitude et la longitude :
https://www.google.com/maps/**@ **47,6086111**, -122,3409953,20 z**
+ Vous pouvez saisir jusqu'à deux décimales de précision, par exemple,. `47.61` Si vous spécifiez une valeur avec une plus grande précision, Route 53 renvoie une erreur. Pour la latitude et la longitude au niveau de l'équateur, 0,01 degré correspond à environ 0,69 miles (1,11 km).
**Écart**
Spécifiez une valeur pour savoir `Bias` si vous souhaitez acheminer plus de trafic vers un point de terminaison à partir de points de terminaison situés à proximité (valeurs positives) ou acheminer moins de trafic vers un point de terminaison (valeurs négatives). La plage des valeurs valides est comprise entre -99 et 99. La valeur par défaut est 0.
La valeur de `Bias` est relative, basée sur l'emplacement des autres ressources, plutôt qu'absolue, basée sur la distance. En conséquence, l'impact des modifications est difficile à prévoir. Par exemple, en fonction de l'emplacement de vos ressources, le fait de modifier le biais de `10` à `15` peut faire la différence entre l'ajout ou la soustraction d'une quantité significative de trafic en provenance de la région métropolitaine de New York. Nous vous conseillons donc de modifier la valeur d'écart par petits incréments et d'évaluer les résultats avant de procéder à des changements supplémentaires, si nécessaire.
**EvaluateTargetHealth**
Un booléen qui indique si vous souhaitez que Route 53 évalue l'état du point de terminaison et achemine le trafic uniquement vers des points de terminaison sains. Pour plus d'informations, consultez [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Si vous souhaitez associer un bilan de santé au point de terminaison ou à la règle, spécifiez l'ID du bilan de santé. Pour plus d'informations, consultez [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Règles de latence
Lorsque vous ajoutez une règle de latence, vous configurez votre politique de trafic pour acheminer votre trafic en fonction de la latence (le délai) entre vos utilisateurs et les AWS régions dans lesquelles vous avez créé des AWS ressources, telles que les équilibreurs de charge ELB et les compartiments Amazon S3. Pour plus d'informations, consultez [Latency Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency) dans le *guide du développeur Amazon Route 53*.
```
1. {
2. "RuleType": "latency",
3. "Regions": [
4. {
5. "EndpointReference | RuleReference": "{{ID that you assigned to the rule or endpoint that this rule routes traffic to}}",
6. "Region": "{{AWS region that you want to route traffic to}}",
7. "EvaluateTargetHealth": "true" | "false",
8. "HealthCheck": "{{optional health check ID}}"
9. },
10. ...
11. ]
12. }
```
Lorsque vous définissez une règle de latence, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `latency`.
**Régions**
Spécifiez un ensemble de valeurs (`EndpointReference`\| `RuleReference``Region`,`EvaluateTargetHealth`, et`HealthCheck`) pour chacune des régions vers lesquelles vous souhaitez acheminer le trafic.
**EndpointReference \| RuleReference**
Si vous souhaitez acheminer le trafic vers un point de terminaison ou vers une autre règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**Région**
Le code de région de la AWS région dans laquelle vous avez créé la ressource. Pour obtenir la liste des codes de région valides, consultez [la section Région](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) dans la documentation relative à [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**EvaluateTargetHealth**
Un booléen qui indique si vous souhaitez qu'Amazon Route 53 évalue l'état du point de terminaison et achemine le trafic uniquement vers des points de terminaison sains. Pour plus d'informations, consultez [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Si vous souhaitez associer un bilan de santé au point de terminaison ou à la règle, spécifiez l'ID du bilan de santé. Pour plus d'informations, consultez [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Règles de réponse à valeurs multiples
Lorsque vous ajoutez une règle de réponse à valeurs multiples, vous configurez votre politique de trafic de manière à acheminer le trafic de manière approximativement aléatoire vers vos ressources saines. Amazon Route 53 répond aux requêtes DNS avec un maximum de huit enregistrements sains ; si vous avez huit enregistrements sains ou moins, Route 53 répond à toutes les requêtes DNS avec tous les enregistrements sains. Pour de plus amples informations, veuillez consulter [MultiValueAnswer](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-MultiValueAnswer).
```
1. {
2. "RuleType": "multivalue",
3. "Items": [
4. {
5. "EndpointReference": "{{ID that you assigned to the endpoint that this rule routes traffic to}}",
6. "HealthCheck": "{{optional health check ID}}"
7. },
8. ...
9. ]
10. }
```
Lorsque vous définissez une règle de réponse à valeurs multiples, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `multivalue`.
**Éléments**
Spécifiez un ensemble de valeurs (`EndpointReference`et`HealthCheck`) pour chacune des règles de réponse à valeurs multiples ou des points de terminaison vers lesquels vous souhaitez acheminer le trafic.
**EndpointReference**
L'ID que vous avez attribué au point de terminaison ailleurs dans le document de politique de trafic.
**HealthCheck**
Si vous souhaitez associer un bilan de santé au terminal, spécifiez l'ID du bilan de santé. Pour de plus amples informations, veuillez consulter [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId).
### Règles pondérées
Lorsque vous ajoutez une règle pondérée, vous configurez votre politique de trafic pour acheminer le trafic en fonction des proportions que vous spécifiez. Par exemple, vous pouvez spécifier des poids de 4, 5, 5 et 6 (somme = 20). Le résultat est que 4/20ths votre trafic est, en moyenne, acheminé vers le premier point de terminaison ou règle, 5/20ths est acheminé à la fois vers les deuxième et troisième points de terminaison ou règles, et 6/20ths est routé vers le dernier point de terminaison ou règle. Pour plus d'informations, consultez la section [Weighted Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted) dans le *manuel du développeur Amazon Route 53*.
```
1. {
2. "RuleType": "weighted",
3. "Items": [
4. {
5. "EndpointReference | RuleReference": "{{ID that you assigned to the rule or endpoint that this rule routes traffic to}}",
6. "Weight": "{{value between 0 and 255}}",
7. "EvaluateTargetHealth": "true" | "false",
8. "HealthCheck": "{{optional health check ID}}"
9. },
10. ...
11. ]
12. }
```
Lorsque vous définissez une règle pondérée, vous spécifiez les objets suivants :
**RuleType**
Spécifiez `weighted`.
**Éléments**
Spécifiez un ensemble de valeurs (`EndpointReference`\|`RuleReference`, `Weight``EvaluateTargetHealth`, et`HealthCheck`) pour chacune des règles pondérées ou des points de terminaison vers lesquels vous souhaitez acheminer le trafic.
**EndpointReference \| RuleReference**
Si vous souhaitez acheminer le trafic vers un point de terminaison ou vers une autre règle, et l'ID que vous avez attribué au point de terminaison ou à la règle ailleurs dans le document de politique de trafic.
**Pondération**
Valeur comprise entre 0 et 255 qui détermine la proportion du trafic acheminé vers le point de terminaison ou la règle correspondant. Pour plus d'informations, consultez la section [Poids](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Weight) dans la documentation relative à [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**EvaluateTargetHealth**
Un booléen qui indique si vous souhaitez qu'Amazon Route 53 évalue l'état du point de terminaison et achemine le trafic uniquement vers des points de terminaison sains. Pour plus d'informations, consultez [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Si vous souhaitez associer un bilan de santé au point de terminaison ou à la règle, spécifiez l'ID du bilan de santé. Pour plus d'informations, consultez [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)la documentation sur [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
## Exemples
Les exemples suivants montrent comment utiliser les règles de basculement, de géolocalisation, de géoproximité, de latence et de pondération, et comment utiliser plusieurs types de règles dans la même politique de trafic.
**Topics**
+ [Exemple de basculement](#traffic-policy-document-format-examples-failover)
+ [Exemple de géolocalisation](#traffic-policy-document-format-examples-geolocation)
+ [Exemples de géoproximité](#traffic-policy-document-format-examples-proximity)
+ [Exemple de latence](#traffic-policy-document-format-examples-latency)
+ [Exemple pondéré](#traffic-policy-document-format-examples-weighted)
+ [Exemple avec règles de basculement, de latence et de géolocalisation](#traffic-policy-document-format-examples-combined)
### Exemple de basculement
```
{
"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"
}
}
}
}
```
### Exemple de géolocalisation
```
{
"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"
}
]
}
}
}
```
### Exemples de géoproximité
```
{
"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"
}
]
}
}
}
```
### Exemple de latence
```
{
"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"
}
]
}
}
}
```
### Exemple pondéré
```
{
"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"
}
]
}
}
}
```
### Exemple avec règles de basculement, de latence et de géolocalisation
```
{
"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"
}
}
}
}
```