As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Formato do documento de política de tráfego
Quando você cria uma política de tráfego programaticamente usando a API Amazon Route 53, um dos AWS SDKs, o, ou AWS CLI AWS Tools for Windows PowerShell, você especifica a definição da política de tráfego em um `Document` elemento no formato JSON.
Para obter mais informações sobre políticas de tráfego, consulte [Usando o fluxo de tráfego para rotear o tráfego DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/traffic-flow.html) no *Guia do desenvolvedor do Amazon Route 53*.
**Topics**
+ [Sintaxe básica](#traffic-policy-document-format-basic)
+ [Sintaxe para definições de endpoint](#traffic-policy-document-format-endpoints)
+ [Sintaxe para definições de regras](#traffic-policy-document-format-rules)
+ [Exemplos](#traffic-policy-document-format-examples)
## Sintaxe básica
Aqui está a sintaxe básica de um documento de política de tráfego:
```
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. }
```
A sintaxe básica de um documento de política de tráfego contém os seguintes objetos:
**AWSPolicyFormatVersion**
A versão do formato da política de tráfego, a versão mais recente que suporta Zonas AWS Locais;`2023-05-09`.
A versão anterior também é suportada;`2015-10-01`.
**RecordType**
O tipo de DNS de todos os registros de recursos que o Amazon Route 53 criará com base nessa política de tráfego. Se você quiser rotear o tráfego para os seguintes AWS recursos, escolha o valor aplicável:
+ **CloudFront distribuição** — Escolha **A: endereço IP no formato IPv4 ou **AAAA: endereço IP no** formato** IPv6.
+ **Application Load Balancer do ELB**: escolha **AA: endereço IP no formato IPv4** ou **AAAA: endereço IP no formato IPv6**.
+ **Classic Load Balancer do ELB**: escolha **A: endereço IP no formato IPv4** ou **AAAA: endereço IP no formato IPv6**.
+ **Network Load Balancer do ELB**: escolha **AA: endereço IP no formato IPv4** ou **AAAA: endereço IP no formato IPv6**.
+ Ambiente do **Elastic** Beanstalk **— Escolha A: endereço IP no formato IPv4 ou AAAA: endereço IP no** **formato** IPv6.
+ **Amazon S3 bucket configured as a website endpoint** (Bucket do Amazon S3 configurado como endpoint do site): escolha **A: IP address in IPv4 format** (A: endereço IP no formato IPv4).
Se você quiser rotear o tráfego para outros recursos, escolha o tipo aplicável para o recurso. Por exemplo, se você quiser rotear o tráfego para servidores de e-mail, especifique`MX`. Para ver a lista de tipos de DNS compatíveis com o Route 53, consulte [Tipos de registro de recursos de DNS compatíveis](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html) no *Amazon Route 53 Developer Guide*.
**StartEndpoint \| StartRule**
Se você deseja que o ponto de partida da política de tráfego seja um endpoint ou uma regra, e a ID que você atribuiu ao endpoint ou regra em outro lugar no documento de política de tráfego.
**Endpoints**
As definições dos endpoints que você deseja usar nessa política de tráfego. Para obter mais informações, consulte [Sintaxe para definições de endpoint](#traffic-policy-document-format-endpoints).
**Regras**
As definições das regras que você deseja usar nessa política de tráfego. Para obter mais informações, consulte [Sintaxe para definições de regras](#traffic-policy-document-format-rules).
## Sintaxe para definições de endpoint
Aqui está a sintaxe das definições de endpoint que você especifica em um documento de política de tráfego:
```
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. }
```
A sintaxe de uma definição de endpoint contém os seguintes objetos:
**Tipo**
Especifique o valor aplicável:
**valor**
Para rotear o tráfego para um recurso diferente dos da lista a seguir, especifique `value` para`Type`.
**cloudfront**
Para rotear o tráfego para uma CloudFront distribuição, especifique `cloudfront` para`Type`.
**balanceador de carga de aplicativos**
Para rotear o tráfego para um Application Load Balancer, especifique `application-load-balancer` para. `Type`
**balanceador de carga elástico**
Para rotear o tráfego para um balanceador de carga ELB Classic, especifique `elastic-load-balancer` para. `Type`
**balanceador de carga de rede**
Para rotear o tráfego para um balanceador de carga de rede ELB, especifique `network-load-balancer` para. `Type`
**pé de feijão elástico**
Para rotear o tráfego para um ambiente do Elastic Beanstalk, especifique para. `elastic-beanstalk` `Type`
**site s3**
Para rotear o tráfego para um bucket do Amazon S3 configurado como um endpoint do site, especifique para. `s3-website` `Type`
**Região**
Para rotear o tráfego para um bucket do Amazon S3 configurado como um endpoint do site, especifique a região na qual você criou o bucket. `Region` Para qualquer outro recurso, omita. `Region`
**Valor**
Especifique o valor aplicável:
**valor**
Para rotear o tráfego para um recurso diferente dos listados abaixo, especifique o valor que corresponde ao valor que você especificou`RecordType`. Por exemplo, se você especificou `A` para`RecordType`, especifique um endereço IP no formato IPv4 para. `Value`
**cloudfront**
Se você especificou `cloudfront` para`Type`, especifique o nome de domínio CloudFront atribuído à sua CloudFront distribuição quando você a criou, por exemplo,`d111111abcdef8.cloudfront.net`.
**balanceador de carga de aplicativos**
Se você especificou `application-load-balancer` para`Type`, especifique o nome DNS do seu balanceador de carga. Por exemplo, .`exampleAlb-1283637735.us-east-1.elb.amazonaws.com`
**balanceador de carga elástico**
Se você especificou `elastic-load-balancer` para`Type`, especifique o nome DNS do seu balanceador de carga. Use o valor que começa com`dualstack`, por exemplo,`dualstack.my-load-balancer-1234567890.us-west-2.elb.amazonaws.com`.
**balanceador de carga de rede**
Se você especificou `network-load-balancer` para`Type`, especifique o nome DNS do seu balanceador de carga. Por exemplo, .`exampleNlb-74f87b114e21682a.elb.us-east-1.amazonaws.com`
**pé de feijão elástico**
Se você especificou `elastic-beanstalk` para`Type`, especifique o nome de domínio do seu ambiente do Elastic Beanstalk. Por exemplo, .`example-beanstalk-env-1.eba-ns4qrife.us-east-1.elasticbeanstalk.com`
**site s3**
Se você especificou `s3-website` para`Type`, especifique o nome do seu bucket do Amazon S3, por exemplo,. `example.com.s3-website-us-east-1.amazonaws.com`
Quando você cria uma instância de política de tráfego com base nessa política de tráfego, o bucket especificado aqui deve corresponder ao nome de domínio (como www.exemplo.com) especificado `Name` na solicitação. [CreateTrafficPolicyInstance](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicyInstance.html) Se `Value` e `Name` não corresponderem, o Amazon S3 não responderá às consultas de DNS para o nome de domínio.
## Sintaxe para definições de regras
Há diferentes sintaxes para as definições de regras que você especifica em um documento de política de tráfego, dependendo do tipo de política de roteamento que você deseja usar: failover, geolocalização, geoproximidade, latência, resposta de vários valores ou ponderada.
**Topics**
+ [Regras de failover](#traffic-policy-document-format-rules-failover)
+ [Regras de geolocalização](#traffic-policy-document-format-rules-geo)
+ [Regras de geoproximidade](#traffic-policy-document-format-rules-geoproximity)
+ [Regras de latência](#traffic-policy-document-format-rules-latency)
+ [Regras de resposta de vários valores](#traffic-policy-document-format-rules-multivalue-answer)
+ [Regras ponderadas](#traffic-policy-document-format-rules-weighted)
### Regras de failover
Para obter mais informações, consulte [Como configurar o failover de DNS no Guia](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring.html) do desenvolvedor do *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. }
```
Ao definir uma regra de failover, você especifica os seguintes objetos:
**RuleType**
Especifique `failover`.
**Primário \| Secundário**
Para o `Primary` objeto, especifique as configurações da regra ou do endpoint para o qual você deseja rotear o tráfego sempre que os recursos correspondentes estiverem disponíveis.
Para o `Secondary` objeto, especifique as configurações da regra ou do endpoint para o qual você deseja rotear o tráfego sempre que os recursos primários não estiverem disponíveis.
**EndpointReference \| RuleReference**
Se você deseja rotear o tráfego para um endpoint ou para outra regra, e a ID que você atribuiu ao endpoint ou à regra em outro lugar no documento de política de tráfego.
**EvaluateTargetHealth**
Um booleano que indica se você deseja que o Amazon Route 53 avalie a integridade do endpoint e direcione o tráfego somente para endpoints íntegros. Para obter mais informações, consulte [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint ou à regra, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Regras de geolocalização
Ao adicionar uma regra de geolocalização, você configura sua política de tráfego para rotear seu tráfego com base na localização geográfica de seus usuários. Para obter mais informações, consulte [Roteamento por geolocalização](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo) no Guia do *desenvolvedor do 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. }
```
Ao definir uma regra de geolocalização, você especifica os seguintes objetos:
**RuleType**
Especifique `geo`.
**Locais**
Especifique um conjunto de valores (`EndpointReference`\|`RuleReference`,`IsDefault`,`Continent`,`Country`, `Subdivision``EvaluateTargetHealth`, e`HealthCheck`) para cada uma das localizações geográficas para as quais você deseja rotear o tráfego.
**EndpointReference \| RuleReference**
Se você deseja rotear o tráfego para um endpoint ou para outra regra, e a ID que você atribuiu ao endpoint ou à regra em outro lugar no documento de política de tráfego.
**IsDefault**
Um booleano que indica se esse conjunto de valores representa o local padrão. Se você especificar `*` como o valor do `CountryCode` elemento em uma localização geográfica, o valor do `IsDefault` elemento para essa localização será definido como padrão e você não poderá especificar `True` como o valor do `IsDefault` elemento em outras localizações geográficas para a mesma regra de geolocalização. `True` Para obter mais informações sobre `*` como especificar o valor do `CountryCode` elemento, consulte a entrada a seguir para`Continent, Country, Subdivision`.
**Continente, país, subdivisão**
Valores que indicam a localização geográfica dos usuários cujo tráfego você deseja rotear para uma regra ou endpoint. Para obter mais informações, consulte as seguintes descrições dos elementos na documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html):
+ `GeoLocation`
+ `ContinentCode`
+ `CountryCode`
+ `SubdivisionCode`
Para obter mais informações, consulte [Localização](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-geo.html#rrsets-values-geo-location) no Guia do desenvolvedor do *Amazon Route 53*.
A localização geográfica funciona através do mapeamento de endereços IP para os locais. No entanto, alguns endereços IP não são mapeados para localizações geográficas, portanto, mesmo que você crie localizações geográficas que cubram todos os sete continentes, o Route 53 receberá algumas consultas de DNS de locais que não consegue identificar. Recomendamos que você crie uma localização geográfica para a qual o valor de `Country` seja`*`. Dois grupos de consultas são roteados para o recurso que você especifica nesse registro: consultas provenientes de locais para os quais você não criou localizações geográficas e consultas de endereços IP que não estão mapeados para um local. Se você não criar uma localização `*` geográfica, o Route 53 retornará uma resposta “sem resposta” para consultas de locais não mapeados.
**EvaluateTargetHealth**
Um booleano que indica se você deseja que o Amazon Route 53 avalie a integridade do endpoint e direcione o tráfego somente para endpoints íntegros. Para obter mais informações, consulte [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint ou à regra, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Regras de geoproximidade
Ao adicionar uma regra de geoproximidade, você configura o Amazon Route 53 para rotear o tráfego para seus recursos com base na localização geográfica dos seus recursos. Opcionalmente, você também pode optar por rotear mais ou menos tráfego para um determinado endpoint ou regra especificando um viés. Você usa um viés para expandir ou reduzir o tamanho da região geográfica a partir da qual o tráfego é roteado para um endpoint ou regra. Para obter mais informações, consulte [Roteamento por geoproximidade](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geoproximity) no Guia do *desenvolvedor do Amazon Route 53*.
O exemplo a seguir serve `AWSPolicyFormatVersion 2023-05-09` apenas para:
```
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. }
```
O exemplo a seguir serve `AWSPolicyFormatVersion 2015-10-01` apenas para:
```
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. }
```
Ao definir uma regra de geoproximidade, você especifica os seguintes objetos:
**RuleType**
Especifique `geoproximity`.
**GeoproximityLocations**
Especifique um conjunto de valores para cada recurso para o qual você deseja rotear o tráfego. Você pode especificar um campo de **localização**, que suporta AWS Regiões, Zonas Locais e latitudes e longitudes em. `AWSPolicyFormatVersion 2023-05-09` Você também pode especificar uma AWS região ou a latitude e longitude de uma localização geográfica em`AWSPolicyFormatVersion 2015-10-01`.
**EndpointReference \| RuleReference**
Se você deseja rotear o tráfego para um endpoint ou para outra regra, e a ID que você atribuiu ao endpoint ou à regra em outro lugar no documento de política de tráfego.
**Localização (`AWSPolicyFormatVersion 2023-05-09`somente)**
O campo Localização suporta AWS Regiões, Zonas Locais e latitudes e longitudes com o seguinte formato:
Para Zonas Locais: `"Location": { "Type": "LocalZone", "LocationName": "aws:route53:us-east-1-atl-1a" }`
Para regiões: `"Location": { "Type": "Region", "LocationName": "aws:route53:us-east-1" },`
Para coordenadas: `"Location": { "Type": "Coordinate", "Latitude": "38.9", "Longitude": "-77.01" },`
Para obter uma lista de códigos de região válidos, consulte [Região](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) na documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
Para ver as zonas locais disponíveis, consulte [Localizações das zonas locais da AWS](https://aws.amazon.com/about-aws/global-infrastructure/localzones/locations/).
**Região (`AWSPolicyFormatVersion 2015-10-01`somente)**
Se seu endpoint for um AWS recurso, especifique a AWS região na qual você criou o recurso. Use o formato a seguir:
`aws:route53:`{{region-code}}
Para obter uma lista de códigos de região válidos, consulte [Região](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) na documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**Latitude e longitude (`AWSPolicyFormatVersion 2015-10-01`somente)**
Se seu endpoint não for um AWS recurso, insira a latitude e a longitude da localização do recurso. Observe o seguinte:
+ A latitude representa a localização sul (negativa) ou norte (positiva) da linha do Equador. Os valores válidos são de -90 graus a 90 graus.
+ A longitude representa a localização oeste (negativa) ou leste (positiva) do primeiro meridiano. Os valores válidos são de -180 graus a 180 graus.
+ Você pode obter a latitude e a longitude em alguns aplicativos de mapas online. Por exemplo, no Google Maps, a URL de um local especifica a latitude e a longitude:
https://www.google.com/maps/**@ **47,6086111**, -122,3409953,20 onças**
+ Você pode inserir até dois decimais de precisão, por exemplo,. `47.61` Se você especificar um valor com maior precisão, o Route 53 retornará um erro. Para a latitude e a longitude na linha do Equador, 0,01 graus é de aproximadamente 0,69 quilômetro.
**Desvio**
Especifique um valor para `Bias` se você quiser rotear mais tráfego para um endpoint a partir de endpoints próximos (valores positivos) ou rotear menos tráfego para um endpoint (valores negativos). O intervalo de valores válidos é -99 a 99; o valor padrão é 0.
O valor de `Bias` é relativo, com base na localização de outros recursos, em vez de absoluto, com base na distância. Como resultado, é difícil prever o efeito de uma alteração. Por exemplo, dependendo de onde estão seus recursos, alterar o viés de `10` para `15` pode significar a diferença entre adicionar ou subtrair uma quantidade significativa de tráfego da área metropolitana de Nova York. Recomendamos que você altere o desvio em pequenos incrementos e avalie os resultados e, em seguida, faça alterações adicionais, se for necessário.
**EvaluateTargetHealth**
Um booleano que indica se você deseja que o Route 53 avalie a integridade do endpoint e direcione o tráfego somente para endpoints íntegros. Para obter mais informações, consulte [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint ou à regra, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Regras de latência
Ao adicionar uma regra de latência, você configura sua política de tráfego para rotear seu tráfego com base na latência (o atraso de tempo) entre seus usuários e as AWS regiões em que você criou AWS recursos, como balanceadores de carga ELB e buckets Amazon S3. Para obter mais informações, consulte [Roteamento de latência](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency) no Guia do *desenvolvedor do 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. }
```
Ao definir uma regra de latência, você especifica os seguintes objetos:
**RuleType**
Especifique `latency`.
**Regiões**
Especifique um conjunto de valores (`EndpointReference`\|`RuleReference`, `Region``EvaluateTargetHealth`, e`HealthCheck`) para cada uma das regiões para as quais você deseja rotear o tráfego.
**EndpointReference \| RuleReference**
Se você deseja rotear o tráfego para um endpoint ou para outra regra, e a ID que você atribuiu ao endpoint ou à regra em outro lugar no documento de política de tráfego.
**Região**
O código da AWS região na qual você criou o recurso. Para obter uma lista de códigos de região válidos, consulte [Região](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) na documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**EvaluateTargetHealth**
Um booleano que indica se você deseja que o Amazon Route 53 avalie a integridade do endpoint e direcione o tráfego somente para endpoints íntegros. Para obter mais informações, consulte [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint ou à regra, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
### Regras de resposta de vários valores
Ao adicionar uma regra de resposta de vários valores, você configura sua política de tráfego para rotear o tráfego de forma aproximadamente aleatória para seus recursos saudáveis. O Amazon Route 53 responde às consultas de DNS com até oito registros íntegros; se você tiver oito ou menos registros íntegros, o Route 53 responderá a todas as consultas de DNS com todos os registros íntegros. Para obter mais informações, consulte [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. }
```
Ao definir uma regra de resposta de vários valores, você especifica os seguintes objetos:
**RuleType**
Especifique `multivalue`.
**Itens**
Especifique um conjunto de valores (`EndpointReference`e`HealthCheck`) para cada uma das regras de resposta de vários valores ou endpoints para os quais você deseja rotear o tráfego.
**EndpointReference**
A ID que você atribuiu ao endpoint em outro lugar no documento de política de tráfego.
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId).
### Regras ponderadas
Ao adicionar uma regra ponderada, você configura sua política de tráfego para rotear o tráfego com base nas proporções que você especificar. Por exemplo, você pode especificar pesos de 4, 5, 5 e 6 (soma = 20). O resultado é que 4/20ths seu tráfego, em média, é roteado para o primeiro endpoint ou regra, 5/20ths é roteado para o segundo e o terceiro endpoints ou regras e 6/20ths é roteado para o último endpoint ou regra. Para mais informações, consulte [Roteamento ponderado](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted) no *Guia do desenvolvedor do 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. }
```
Ao definir uma regra ponderada, você especifica os seguintes objetos:
**RuleType**
Especifique `weighted`.
**Itens**
Especifique um conjunto de valores (`EndpointReference`\|`RuleReference`, `Weight``EvaluateTargetHealth`, e`HealthCheck`) para cada uma das regras ponderadas ou endpoints para os quais você deseja rotear o tráfego.
**EndpointReference \| RuleReference**
Se você deseja rotear o tráfego para um endpoint ou para outra regra, e a ID que você atribuiu ao endpoint ou à regra em outro lugar no documento de política de tráfego.
**Weight**
Um valor entre 0 e 255 que determina a proporção do tráfego que é roteado para o endpoint ou regra correspondente. Para obter mais informações, consulte [Peso](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Weight) na documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**EvaluateTargetHealth**
Um booleano que indica se você deseja que o Amazon Route 53 avalie a integridade do endpoint e direcione o tráfego somente para endpoints íntegros. Para obter mais informações, consulte [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
**HealthCheck**
Se você quiser associar uma verificação de saúde ao endpoint ou à regra, especifique a ID da verificação de saúde. Para obter mais informações, consulte [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)a documentação sobre [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html).
## Exemplos
Os exemplos a seguir mostram como usar regras de failover, geolocalização, geoproximidade, latência e ponderadas, e como usar vários tipos de regras na mesma política de tráfego.
**Topics**
+ [Exemplo de failover](#traffic-policy-document-format-examples-failover)
+ [Exemplo de geolocalização](#traffic-policy-document-format-examples-geolocation)
+ [Exemplos de geoproximidade](#traffic-policy-document-format-examples-proximity)
+ [Exemplo de latência](#traffic-policy-document-format-examples-latency)
+ [Exemplo ponderado](#traffic-policy-document-format-examples-weighted)
+ [Exemplo com regras de failover, latência e geolocalização](#traffic-policy-document-format-examples-combined)
### Exemplo de 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"
}
}
}
}
```
### Exemplo de geolocalização
```
{
"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"
}
]
}
}
}
```
### Exemplos de geoproximidade
```
{
"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"
}
]
}
}
}
```
### Exemplo de latência
```
{
"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"
}
]
}
}
}
```
### Exemplo ponderado
```
{
"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"
}
]
}
}
}
```
### Exemplo com regras de failover, latência e geolocalização
```
{
"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"
}
}
}
}
```