Route53Configuration

Configura los conjuntos de registros de Route53 para una API.

Sintaxis

Para declarar esta entidad en su plantilla de AWS Serverless Application Model (AWS SAM), use la siguiente sintaxis:

YAML

  DistributionDomainName: String
  EvaluateTargetHealth: Boolean
  HostedZoneId: String
  HostedZoneName: String
  IpV6: Boolean
  Region: String
  SetIdentifier: String

Propiedades

DistributionDomainName

Configura una distribución personalizada del nombre de dominio personalizado de la API.

Tipo: cadena

Obligatorio: no

Predeterminado: utilice la distribución de API Gateway.

Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad DNSName de un recurso AWS::Route53::RecordSetGroup AliasTarget.

Notas adicionales: El nombre de dominio de una CloudFrontdistribución.

EvaluateTargetHealth

Si EvaluateTargetHealth es verdadero, un registro de alias hereda el estado del AWS recurso al que se hace referencia, como un balanceador de cargas de Elastic Load Balancing u otro registro de la zona alojada.

Tipo: Booleano

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad EvaluateTargetHealth de un recurso AWS::Route53::RecordSetGroup AliasTarget.

Notas adicionales: No se puede EvaluateTargetHealth establecer como verdadero cuando el alias objetivo es una CloudFront distribución.

HostedZoneId

ID de la zona alojada en la que desea crear registros.

Especifique HostedZoneName o HostedZoneId, pero no ambos. Si tiene múltiples zonas hospedadas con el mismo nombre de dominio, debe especificar la zona hospedada mediante HostedZoneId.

Tipo: cadena

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad HostedZoneId de un recurso AWS::Route53::RecordSetGroup RecordSet.

HostedZoneName

El nombre de la zona alojada en la que desea crear registros.

Especifique HostedZoneName o HostedZoneId, pero no ambos. Si tiene múltiples zonas hospedadas con el mismo nombre de dominio, debe especificar la zona hospedada mediante HostedZoneId.

Tipo: cadena

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad HostedZoneName de un recurso AWS::Route53::RecordSetGroup RecordSet.

IpV6

Cuando se establece esta propiedad, AWS SAM crea un AWS::Route53::RecordSet recurso y establece Type en AAAA el valor proporcionado HostedZone.

Tipo: Booleano

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad es exclusiva de AWS SAM y no tiene un equivalente AWS CloudFormation.

Region

Solo conjuntos de registros de recursos de latencia: La región de Amazon EC2 donde haya creado el recurso al que se refiere este conjunto de registros de recursos. El recurso normalmente es un recurso de AWS, como una instancia de EC2 o un equilibrador de carga de ELB, y se hace referencia a él mediante una dirección IP o un nombre de dominio DNS, en función del tipo de registro.

Cuando Amazon Route 53 recibe una consulta de DNS para un nombre de dominio y tipo para los que ha creado conjuntos de registros de recursos de latencia, Route 53 selecciona el conjunto de registros de recursos de latencia con la menor latencia entre el usuario final y la región de Amazon EC2 asociada. Route 53 devuelve a continuación el valor asociado con el conjunto de registros de recursos seleccionados.

Tenga en cuenta lo siguiente:

• Solo puede especificar un ResourceRecord por conjunto de registros de recursos de latencia.

• Solo puede crear un conjunto de registros de recursos de latencia para cada región de Amazon EC2.

• No es necesario que cree conjuntos de registros de recursos de latencia para todas las regiones de Amazon EC2. Route 53 elige la región con la mejor latencia entre las regiones para las que crea conjuntos de registros de recursos de latencia.

• No puede crear conjuntos de registros de recursos sin latencia que tengan los mismos valores Name y Type que los conjuntos de registros de recursos de latencia.

Tipo: cadena

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad pasa directamente a la propiedad Region del tipo de datos RecordSet de AWS::Route53::RecordSetGroup.

SetIdentifier

Conjuntos de registros de recursos que tienen una política de direccionamiento que no es simple: Un identificador que diferencia entre varios conjuntos de registros de recursos con la misma combinación de nombre y tipo, como varios conjuntos de registros de recursos ponderados denominados acme.example.com de tipo A. En un grupo de conjuntos de registros de recursos que tengan el mismo nombre y tipo, el valor de SetIdentifier debe ser exclusivo para cada conjunto de registros de recursos.

Para obtener información sobre cómo dirigir las políticas, consulte Elección de una política de direccionamiento en la Guía para desarrolladores de Amazon Route 53.

Tipo: cadena

Obligatorio: no

Compatibilidad con AWS CloudFormation: esta propiedad pasa directamente a la propiedad SetIdentifier del tipo de datos RecordSet de AWS::Route53::RecordSetGroup.

Ejemplos

Ejemplo básico

En este ejemplo, configuramos un dominio personalizado y conjuntos de registros de Route 53 para nuestra API.

YAML

Resources:
  MyApi:
    Type: AWS::Serverless::Api
    Properties:
      StageName: Prod
      Domain:
        DomainName: www.example.com
        CertificateArn: arn:aws:acm:us-east-1:123456789012:certificate/abcdef12-3456-7890-abcd-ef1234567890
        EndpointConfiguration: REGIONAL
        Route53:
          HostedZoneId: ABCDEFGHIJKLMNOP