Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Formato del documento sulla politica del traffico Quando crei una politica di traffico in modo programmatico utilizzando l'API Amazon Route 53, uno degli AWS SDK, o AWS CLI AWS Tools for Windows PowerShell, specifichi la definizione della politica del traffico in un `Document` elemento in formato JSON. Per ulteriori informazioni sulle politiche del traffico, consulta [Using Traffic Flow to routing DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/traffic-flow.html) nella *Amazon Route 53 Developer Guide*. **Topics** + [Sintassi di base](#traffic-policy-document-format-basic) + [Sintassi per le definizioni degli endpoint](#traffic-policy-document-format-endpoints) + [Sintassi per le definizioni delle regole](#traffic-policy-document-format-rules) + [Esempi](#traffic-policy-document-format-examples) ## Sintassi di base Ecco la sintassi di base per un documento sulla politica del traffico: ``` 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 sintassi di base per un documento di politica del traffico contiene i seguenti oggetti: **AWSPolicyFormatVersion** La versione del formato della politica del traffico, l'ultima versione che supporta AWS Local Zones;`2023-05-09`. È supportata anche la versione precedente;`2015-10-01`. **RecordType** Il tipo DNS di tutti i set di record di risorse che Amazon Route 53 creerà in base a questa politica sul traffico. Se desideri indirizzare il traffico verso le seguenti AWS risorse, scegli il valore applicabile: + **CloudFront distribuzione**: scegli **A: indirizzo IP in formato IPv4 o **AAAA: indirizzo IP in** formato** IPv6. + **Application Load Balancer ELB**: seleziona **A: indirizzo IP in formato IPv4** o **AAAA: indirizzo IP in formato IPv6**. + **Classic Load Balancer ELB**: seleziona **A: indirizzo IP in formato IPv4** o **AAAA: indirizzo IP in formato IPv6**. + **Network Load Balancer ELB**: seleziona **A: indirizzo IP in formato IPv4** o **AAAA: indirizzo IP in formato IPv6**. + Ambiente **Elastic Beanstalk**: **scegli A: indirizzo IP in formato IPv4 o AAAA: indirizzo IP in** **formato** IPv6. + **Bucket Amazon S3 configurato come un endpoint di sito Web**: seleziona **A: indirizzo IP in formato IPv4)**. Se desideri indirizzare il traffico verso altre risorse, scegli il tipo applicabile per la risorsa. Ad esempio, se desideri indirizzare il traffico verso i server di posta, specifica`MX`. Per l'elenco dei tipi di DNS [supportati da Route 53, consulta Supported DNS Resource Record Types](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html) nella *Amazon Route 53 Developer Guide*. **StartEndpoint \| StartRule** Se desideri che il punto di partenza per la politica del traffico sia un endpoint o una regola e l'ID che hai assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **Endpoints** Le definizioni degli endpoint che desideri utilizzare in questa politica sul traffico. Per ulteriori informazioni, consulta [Sintassi per le definizioni degli endpoint](#traffic-policy-document-format-endpoints). **Regole** Le definizioni delle regole che desideri utilizzare in questa politica sul traffico. Per ulteriori informazioni, consulta [Sintassi per le definizioni delle regole](#traffic-policy-document-format-rules). ## Sintassi per le definizioni degli endpoint Ecco la sintassi per le definizioni degli endpoint specificate in un documento di politica del traffico: ``` 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 sintassi per una definizione di endpoint contiene i seguenti oggetti: **Tipo** Specificare il valore applicabile: **value** Per indirizzare il traffico verso una risorsa diversa da quelle nell'elenco seguente, specificare `value` for`Type`. **cloudfront** Per indirizzare il traffico verso una CloudFront distribuzione, specificare `cloudfront` for`Type`. **sistema di bilanciamento del carico delle applicazioni** Per indirizzare il traffico verso un Application Load Balancer, specificare `application-load-balancer` for. `Type` **elastic-load-balancer** Per indirizzare il traffico verso un sistema di bilanciamento del carico ELB Classic, specificare for. `elastic-load-balancer` `Type` **sistema di bilanciamento del carico di rete** Per indirizzare il traffico verso un sistema di bilanciamento del carico di rete ELB, specificare for. `network-load-balancer` `Type` **elastic-beanstalk** Per indirizzare il traffico verso un ambiente Elastic Beanstalk, specificare for. `elastic-beanstalk` `Type` **sito web s3** Per indirizzare il traffico verso un bucket Amazon S3 configurato come endpoint del sito Web, specifica for. `s3-website` `Type` **Region** Per indirizzare il traffico verso un bucket Amazon S3 configurato come endpoint del sito Web, specifica la regione per cui hai creato il bucket. `Region` Per qualsiasi altra risorsa, ometti. `Region` **Valore** Specificate il valore applicabile: **value** Per indirizzare il traffico verso una risorsa diversa da quelle elencate di seguito, specifica il valore corrispondente al valore per cui hai specificato`RecordType`. Ad esempio, se hai specificato `A` for`RecordType`, specifica un indirizzo IP in formato IPv4 per. `Value` **cloudfront** Se hai specificato `cloudfront` for`Type`, specifica il nome di dominio CloudFront assegnato alla tua CloudFront distribuzione al momento della creazione, ad esempio. `d111111abcdef8.cloudfront.net` **application-load-balancer** Se hai specificato `application-load-balancer` for`Type`, specifica il nome DNS del tuo sistema di bilanciamento del carico. Ad esempio, `exampleAlb-1283637735.us-east-1.elb.amazonaws.com`. **elastic-load-balancer** Se hai specificato `elastic-load-balancer` for`Type`, specifica il nome DNS del tuo sistema di bilanciamento del carico. Utilizzate il valore che inizia con`dualstack`, ad esempio,. `dualstack.my-load-balancer-1234567890.us-west-2.elb.amazonaws.com` **sistema di bilanciamento del carico di rete** Se hai specificato `network-load-balancer` for`Type`, specifica il nome DNS del tuo sistema di bilanciamento del carico. Ad esempio, `exampleNlb-74f87b114e21682a.elb.us-east-1.amazonaws.com`. **elastic-beanstalk** Se hai specificato `elastic-beanstalk` for`Type`, specifica il nome di dominio per il tuo ambiente Elastic Beanstalk. Ad esempio, `example-beanstalk-env-1.eba-ns4qrife.us-east-1.elasticbeanstalk.com`. **sito web s3** Se hai specificato `s3-website` for`Type`, specifica il nome del tuo bucket Amazon S3, ad esempio. `example.com.s3-website-us-east-1.amazonaws.com` Quando crei un'istanza di politica del traffico basata su questa politica di traffico, il bucket che specifichi qui deve corrispondere al nome di dominio (ad esempio www.example.com) specificato nella richiesta. `Name` [CreateTrafficPolicyInstance](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicyInstance.html) Se `Value` e `Name` non corrispondono, Amazon S3 non risponderà alle richieste DNS per il nome di dominio. ## Sintassi per le definizioni delle regole Esistono diverse sintassi per le definizioni delle regole specificate in un documento di politica del traffico, a seconda del tipo di politica di routing che si desidera utilizzare: failover, geolocalizzazione, geoprossimità, latenza, risposta multivalore o ponderata. **Topics** + [Regole di failover](#traffic-policy-document-format-rules-failover) + [Regole di geolocalizzazione](#traffic-policy-document-format-rules-geo) + [Regole di geoprossimità](#traffic-policy-document-format-rules-geoproximity) + [Regole di latenza](#traffic-policy-document-format-rules-latency) + [Regole di risposta multivalore](#traffic-policy-document-format-rules-multivalue-answer) + [Regole ponderate](#traffic-policy-document-format-rules-weighted) ### Regole di failover Per ulteriori informazioni, consulta la sezione [Configurazione del failover DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring.html) nella *Amazon Route 53* Developer Guide. ``` 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. } ``` Quando definisci una regola di failover, specifichi i seguenti oggetti: **RuleType** Specifica `failover`. **Primario \| Secondario** Per l'`Primary`oggetto, specificate le impostazioni per la regola o l'endpoint verso cui indirizzare il traffico ogni volta che le risorse corrispondenti sono disponibili. Per l'`Secondary`oggetto, specifica le impostazioni per la regola o l'endpoint verso cui indirizzare il traffico ogni volta che le risorse principali non sono disponibili. **EndpointReference \| RuleReference** Se desideri indirizzare il traffico verso un endpoint o verso un'altra regola e l'ID che hai assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **EvaluateTargetHealth** Un valore booleano che indica se desideri che Amazon Route 53 valuti lo stato dell'endpoint e indirizzi il traffico solo verso endpoint integri. Per ulteriori informazioni, consulta la documentazione [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)su. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **HealthCheck** Se desideri associare un controllo sanitario all'endpoint o alla regola, specifica l'ID del controllo. Per ulteriori informazioni, [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)consulta la documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). ### Regole di geolocalizzazione Quando aggiungi una regola di geolocalizzazione, configuri la tua politica sul traffico in modo da indirizzare il traffico in base alla posizione geografica degli utenti. Per ulteriori informazioni, consulta [Geolocation Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo) nella *Amazon Route 53* Developer Guide. ``` 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. } ``` Quando definisci una regola di geolocalizzazione, specifichi i seguenti oggetti: **RuleType** Specifica `geo`. **Posizioni** Specificate un set di valori (`EndpointReference`\| `RuleReference` `IsDefault``Continent`,`Country`,`Subdivision`,`EvaluateTargetHealth`,, e`HealthCheck`) per ciascuna delle località geografiche verso cui indirizzare il traffico. **EndpointReference \| RuleReference** Se desideri indirizzare il traffico verso un endpoint o verso un'altra regola e l'ID assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **IsDefault** Un valore booleano che indica se questo set di valori rappresenta la posizione predefinita. Se si specifica `*` come valore dell'`CountryCode`elemento in una posizione geografica, il valore dell'`IsDefault`elemento per questa posizione è impostato su di `True` default e non è possibile specificare `True` come valore per l'`IsDefault`elemento in altre posizioni geografiche per la stessa regola di geolocalizzazione. Per ulteriori informazioni sulla specificazione `*` come valore per l'`CountryCode`elemento, vedere la seguente voce per. `Continent, Country, Subdivision` **Continente, Paese, Suddivisione** Valori che indicano la posizione geografica degli utenti il cui traffico si desidera indirizzare verso una regola o un endpoint. Per ulteriori informazioni, consulta le seguenti descrizioni degli elementi nella documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html): + `GeoLocation` + `ContinentCode` + `CountryCode` + `SubdivisionCode` Per ulteriori informazioni, consulta la sezione [Posizione](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-geo.html#rrsets-values-geo-location) nella *Amazon Route 53* Developer Guide. La geolocalizzazione funziona attraverso la mappatura di indirizzi IP alle posizioni. Tuttavia, alcuni indirizzi IP non sono mappati su posizioni geografiche, quindi anche se crei località geografiche che coprono tutti e sette i continenti, Route 53 riceverà alcune query DNS da località che non è in grado di identificare. Ti consigliamo di creare una posizione geografica per cui il valore di è. `Country` `*` Alla risorsa specificata in questo record vengono indirizzati due gruppi di query: query che provengono da località per le quali non sono state create posizioni geografiche e query da indirizzi IP che non sono mappati a una posizione. Se non crei una posizione `*` geografica, Route 53 restituisce una risposta «senza risposta» per le domande provenienti da località non mappate. **EvaluateTargetHealth** Un valore booleano che indica se desideri che Amazon Route 53 valuti lo stato dell'endpoint e indirizzi il traffico solo verso endpoint integri. Per ulteriori informazioni, consulta la documentazione [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)su. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **HealthCheck** Se desideri associare un controllo sanitario all'endpoint o alla regola, specifica l'ID del controllo. Per ulteriori informazioni, [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)consulta la documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). ### Regole di geoprossimità Quando aggiungi una regola di geoprossimità, configuri Amazon Route 53 per indirizzare il traffico verso le tue risorse in base alla posizione geografica delle risorse. Opzionalmente, puoi anche scegliere di indirizzare più o meno traffico verso un determinato endpoint o regola specificando un bias. Si utilizza una distorsione per espandere o ridurre le dimensioni dell'area geografica da cui il traffico viene indirizzato a un endpoint o a una regola. Per ulteriori informazioni, consulta [Geoproximity Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geoproximity) nella *Amazon Route 53 Developer Guide*. L'esempio seguente è solo per`AWSPolicyFormatVersion 2023-05-09`: ``` 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'esempio seguente è `AWSPolicyFormatVersion 2015-10-01` solo per: ``` 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. } ``` Quando si definisce una regola di geoprossimità, si specificano i seguenti oggetti: **RuleType** Specifica `geoproximity`. **GeoproximityLocations** Specificate un set di valori per ogni risorsa verso cui indirizzare il traffico. È possibile specificare un campo **Location**, che supporta AWS Regions, Local Zones e latitudini e longitudini in. `AWSPolicyFormatVersion 2023-05-09` È inoltre possibile specificare una AWS regione o la latitudine e la longitudine di una posizione geografica in. `AWSPolicyFormatVersion 2015-10-01` **EndpointReference \| RuleReference** Se si desidera indirizzare il traffico verso un endpoint o verso un'altra regola e l'ID assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **Ubicazione (solo) `AWSPolicyFormatVersion 2023-05-09`** Il campo Location supporta AWS Regions, Local Zones e latitudini e longitudini con il seguente formato: Per Local Zones: `"Location": { "Type": "LocalZone", "LocationName": "aws:route53:us-east-1-atl-1a" }` Per le regioni: `"Location": { "Type": "Region", "LocationName": "aws:route53:us-east-1" },` Per le coordinate: `"Location": { "Type": "Coordinate", "Latitude": "38.9", "Longitude": "-77.01" },` Per un elenco dei codici regionali validi, consulta [Region](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) nella documentazione relativa a [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). Per le zone locali disponibili, consulta [Posizioni delle zone locali AWS](https://aws.amazon.com/about-aws/global-infrastructure/localzones/locations/). **Regione (`AWSPolicyFormatVersion 2015-10-01`solo)** Se l'endpoint è una AWS risorsa, specifica la AWS regione in cui hai creato la risorsa. Utilizza il seguente formato: `aws:route53:`{{region-code}} Per un elenco di codici regionali validi, consulta [Region](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) nella documentazione relativa [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). **Latitudine e longitudine (solo) `AWSPolicyFormatVersion 2015-10-01`** Se l'endpoint non è una AWS risorsa, inserisci la latitudine e la longitudine della posizione della risorsa. Tenere presente quanto segue: + La latitudine rappresenta la posizione a sud (negativo) o a nord (positivo) dell'equatore. I valori validi sono compresi tra -90 e 90 gradi. + La longitudine rappresenta la posizione a ovest (negativo) o a est (positivo) del meridiano primario. I valori validi sono compresi tra -180 e 180 gradi. + Puoi ottenere latitudine e longitudine da alcune applicazioni di mappatura online. Ad esempio, in Google Maps, l'URL per una posizione specifica la latitudine e longitudine: https://www.google.com/maps/**@ **47.6086111**, -122.3409953, 20z** + È possibile inserire fino a due decimali di precisione, ad esempio. `47.61` Se si specifica un valore con maggiore precisione, Route 53 restituisce un errore. Per latitudine e longitudine all'equatore, 0,01 gradi corrisponde a circa 0,69 miglia. **Bias** Specificate un valore per `Bias` indirizzare più traffico verso un endpoint da endpoint vicini (valori positivi) o indirizzare meno traffico verso un endpoint (valori negativi). L'intervallo di valori validi è compreso tra -99 e 99; il valore predefinito è 0. Il valore di `Bias` è relativo, basato sulla posizione di altre risorse, anziché assoluto, in base alla distanza. Di conseguenza, l'effetto di una modifica è difficile prevedere. Ad esempio, a seconda di dove si trovano le risorse, la modifica della polarizzazione da `10` a `15` può fare la differenza tra l'aggiunta o la sottrazione di una quantità significativa di traffico dall'area metropolitana di New York City. È consigliabile modificare il bias di piccoli incrementi, valutare i risultati e quindi apportare modifiche aggiuntive, se necessario. **EvaluateTargetHealth** Un valore booleano che indica se si desidera che Route 53 valuti lo stato dell'endpoint e indirizzi il traffico solo verso endpoint integri. Per ulteriori informazioni, consulta la documentazione [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)su. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **HealthCheck** Se desideri associare un controllo sanitario all'endpoint o alla regola, specifica l'ID del controllo. Per ulteriori informazioni, [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)consulta la documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). ### Regole di latenza Quando aggiungi una regola di latenza, configuri la tua politica del traffico per indirizzare il traffico in base alla latenza (il ritardo temporale) tra gli utenti e le AWS regioni in cui hai creato AWS risorse come i sistemi di bilanciamento del carico ELB e i bucket Amazon S3. Per ulteriori informazioni, consulta [Latency Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency) nella *Amazon Route 53 Developer Guide*. ``` 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. } ``` Quando definisci una regola di latenza, specifichi i seguenti oggetti: **RuleType** Specifica `latency`. **Regioni** Specificate un set di valori (`EndpointReference`\| `RuleReference` `Region``EvaluateTargetHealth`,, e`HealthCheck`) per ciascuna delle regioni verso cui indirizzare il traffico. **EndpointReference \| RuleReference** Se si desidera indirizzare il traffico verso un endpoint o verso un'altra regola e l'ID assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **Region** Il codice regionale della AWS regione in cui hai creato la risorsa. Per un elenco dei codici regionali validi, consulta [Region](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Region) nella documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). **EvaluateTargetHealth** Un valore booleano che indica se desideri che Amazon Route 53 valuti lo stato dell'endpoint e indirizzi il traffico solo verso endpoint integri. Per ulteriori informazioni, consulta la documentazione [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)su. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **HealthCheck** Se desideri associare un controllo sanitario all'endpoint o alla regola, specifica l'ID del controllo. Per ulteriori informazioni, [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)consulta la documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). ### Regole di risposta multivalore Quando si aggiunge una regola di risposta multivalore, si configura la politica del traffico in modo da indirizzare il traffico in modo approssimativamente casuale verso le risorse disponibili. Amazon Route 53 risponde alle query DNS con un massimo di otto record integri; se hai otto o meno record integri, Route 53 risponde a tutte le query DNS con tutti i record integri. Per ulteriori informazioni, consulta [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. } ``` Quando definisci una regola di risposta multivalore, specifichi i seguenti oggetti: **RuleType** Specifica `multivalue`. **Item** Specificate un set di valori (`EndpointReference`e`HealthCheck`) per ogni regola di risposta multivalore o endpoint verso cui indirizzare il traffico. **EndpointReference** L'ID che hai assegnato all'endpoint altrove nel documento sulla politica del traffico. **HealthCheck** Se desideri associare un controllo sanitario all'endpoint, specifica l'ID del controllo sanitario. Per ulteriori informazioni, consulta [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId). ### Regole ponderate Quando si aggiunge una regola ponderata, si configura la politica del traffico in modo da indirizzare il traffico in base alle proporzioni specificate. Ad esempio, puoi specificare pesi di 4, 5, 5 e 6 (sum=20). Il risultato è che 4/20ths il traffico, in media, viene indirizzato al primo endpoint o regola, 5/20ths viene indirizzato sia al secondo che al terzo endpoint o regola e 6/20ths viene indirizzato all'ultimo endpoint o regola. Per ulteriori informazioni, consulta [Weighted Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted) nella *Amazon Route 53 Developer Guide*. ``` 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. } ``` Quando definisci una regola ponderata, specifichi i seguenti oggetti: **RuleType** Specifica `weighted`. **Item** Specificate un set di valori (`EndpointReference`\| `RuleReference``Weight`,`EvaluateTargetHealth`, e`HealthCheck`) per ciascuna delle regole o degli endpoint ponderati verso cui indirizzare il traffico. **EndpointReference \| RuleReference** Se desideri indirizzare il traffico verso un endpoint o verso un'altra regola e l'ID che hai assegnato all'endpoint o alla regola altrove nel documento sulla politica del traffico. **Weight** Un valore compreso tra 0 e 255 che determina la percentuale di traffico indirizzata all'endpoint o alla regola corrispondente. Per ulteriori informazioni, vedere [Weight](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-Weight) nella documentazione relativa a. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **EvaluateTargetHealth** Un valore booleano che indica se desideri che Amazon Route 53 valuti lo stato dell'endpoint e indirizzi il traffico solo verso endpoint integri. Per ulteriori informazioni, consulta la documentazione [EvaluateTargetHealth](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth)su. [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) **HealthCheck** Se desideri associare un controllo sanitario all'endpoint o alla regola, specifica l'ID del controllo. Per ulteriori informazioni, [HealthCheckId](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId)consulta la documentazione su [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html). ## Esempi Gli esempi seguenti mostrano come utilizzare regole di failover, geolocalizzazione, geoprossimità, latenza e ponderate e come utilizzare più tipi di regole nella stessa politica sul traffico. **Topics** + [Esempio di failover](#traffic-policy-document-format-examples-failover) + [Esempio di geolocalizzazione](#traffic-policy-document-format-examples-geolocation) + [Esempi di geoprossimità](#traffic-policy-document-format-examples-proximity) + [Esempio di latenza](#traffic-policy-document-format-examples-latency) + [Esempio ponderato](#traffic-policy-document-format-examples-weighted) + [Esempio con regole di failover, latenza e geolocalizzazione](#traffic-policy-document-format-examples-combined) ### Esempio di 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" } } } } ``` ### Esempio di geolocalizzazione ``` { "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" } ] } } } ``` ### Esempi di geoprossimità ``` { "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" } ] } } } ``` ### Esempio di latenza ``` { "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" } ] } } } ``` ### Esempio ponderato ``` { "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" } ] } } } ``` ### Esempio con regole di failover, latenza e geolocalizzazione ``` { "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" } } } } ```