Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Formato de documento de política de tráfico

Cuando crea una política de tráfico mediante programación mediante la API de Amazon Route 53, uno de los AWS SDK, o bien AWS CLI AWS Tools for Windows PowerShell, especifica la definición de la política de tráfico en un Document elemento en formato JSON.

Para obtener más información sobre las políticas de tráfico, consulte Uso del flujo de tráfico para enrutar el tráfico de DNS en la Guía para desarrolladores de Amazon Route 53.

Sintaxis básica

Esta es la sintaxis básica de un documento de política de tráfico:

{
   "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 sintaxis básica de un documento de política de tráfico contiene los siguientes objetos:

Sintaxis de las definiciones de puntos finales

Esta es la sintaxis de las definiciones de puntos finales que especifique en un documento de política de tráfico:

{
   "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 sintaxis de una definición de punto final contiene los siguientes objetos:

Sintaxis de las definiciones de reglas

Existen diferentes sintaxis para las definiciones de reglas que especifique en un documento de política de tráfico, según el tipo de política de enrutamiento que desee utilizar: conmutación por error, geolocalización, geoproximidad, latencia, respuesta multivalor o ponderada.

Reglas de conmutación por error

Para obtener más información, consulte Configuración de la conmutación por error de DNS en la Guía para desarrolladores de 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"
   }
}

Al definir una regla de conmutación por error, debe especificar los siguientes objetos:

Reglas de geolocalización

Cuando agregas una regla de geolocalización, configuras tu política de tráfico para enrutar el tráfico en función de la ubicación geográfica de tus usuarios. Para obtener más información, consulte Enrutamiento por geolocalización en la Guía para desarrolladores de 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"
      },
      ...
   ]
}

Al definir una regla de geolocalización, debe especificar los siguientes objetos:

Reglas de geoproximidad

Cuando agrega una regla de geoproximidad, configura Amazon Route 53 para que dirija el tráfico a sus recursos en función de la ubicación geográfica de los recursos. También puede optar por enrutar más o menos tráfico a un punto final o regla determinados especificando un sesgo. El sesgo se utiliza para ampliar o reducir el tamaño de la región geográfica desde la que se enruta el tráfico a un punto final o regla. Para obtener más información, consulte Geoproximity Routing en la Guía para desarrolladores de Amazon Route 53.

El siguiente ejemplo es AWSPolicyFormatVersion 2023-05-09 únicamente para:

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

El siguiente ejemplo es AWSPolicyFormatVersion 2015-10-01 únicamente para:

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

Al definir una regla de geoproximidad, se especifican los siguientes objetos:

Reglas de latencia

Cuando agrega una regla de latencia, configura su política de tráfico para enrutar el tráfico en función de la latencia (el retraso) entre sus usuarios y AWS las regiones en las que ha creado AWS recursos, como los balanceadores de carga ELB y los buckets de Amazon S3. Para obtener más información, consulte Latency Route en la Guía para desarrolladores de 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"
      },
      ...
   ]
}

Al definir una regla de latencia, se especifican los siguientes objetos:

Reglas de respuesta con varios valores

Cuando agrega una regla de respuesta con varios valores, configura su política de tráfico para que dirija el tráfico de forma aproximadamente aleatoria a sus recursos en buen estado. Amazon Route 53 responde a las consultas de DNS con hasta ocho registros en buen estado; si tiene ocho o menos registros en buen estado, Route 53 responde a todas las consultas de DNS con todos los registros en buen estado. Para obtener más información, consulte MultiValueAnswer.

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

Al definir una regla de respuesta con varios valores, se especifican los siguientes objetos:

Reglas ponderadas

Cuando agrega una regla ponderada, configura su política de tráfico para enrutar el tráfico en función de las proporciones que especifique. Por ejemplo, puede especificar pesos de 4, 5, 5 y 6 (suma = 20). El resultado es que 4/20ths el tráfico, en promedio, se enruta al primer punto final o regla, 5/20ths se enruta al segundo y tercer punto final o regla y 6/20ths se enruta al último punto final o regla. Para obtener más información, consulte Enrutamiento ponderado en la Guía para desarrolladores de 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"
      },
      ...
   ]
}

Al definir una regla ponderada, se especifican los siguientes objetos:

Ejemplos

Los siguientes ejemplos muestran cómo usar las reglas de conmutación por error, geolocalización, geoproximidad, latencia y ponderación, y cómo usar varios tipos de reglas en la misma política de tráfico.

Ejemplo de conmutación por error

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

Ejemplo de geolocalización

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

Ejemplos de geoproximidad

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

Ejemplo de latencia

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

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

Ejemplo con reglas de conmutación por error, latencia y geolocalización

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