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 dans le manuel Amazon Route 53 Developer Guide.

Syntaxe de base

Voici la syntaxe de base d'un document de politique de trafic :

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

La syntaxe de base d'un document de politique de trafic contient les objets suivants :

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 :

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

La syntaxe d'une définition de point de terminaison contient les objets suivants :

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.

Règles de basculement

Pour plus d'informations, consultez la section Configuration du basculement DNS dans le guide du développeur Amazon Route 53.

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

Lorsque vous définissez une règle de basculement, vous spécifiez les objets suivants :

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 dans le guide du développeur 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"
      },
      ...
   ]
}

Lorsque vous définissez une règle de géolocalisation, vous spécifiez les objets suivants :

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 dans le guide du développeur Amazon Route 53.

L'exemple suivant ne concerne AWSPolicyFormatVersion 2023-05-09 que :

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

L'exemple suivant ne concerne AWSPolicyFormatVersion 2015-10-01 que :

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

Lorsque vous définissez une règle de géoproximité, vous spécifiez les objets suivants :

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 dans le guide du développeur 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"
      },
      ...
   ]
}

Lorsque vous définissez une règle de latence, vous spécifiez les objets suivants :

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.

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

Lorsque vous définissez une règle de réponse à valeurs multiples, vous spécifiez les objets suivants :

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 dans le manuel du développeur 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"
      },
      ...
   ]
}

Lorsque vous définissez une règle pondérée, vous spécifiez les objets suivants :

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.

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