Route53Configuration

Filtrar vista

All

Configura los conjuntos de registros de Route53 para una API.

Sintaxis

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa 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.

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la DNSName propiedad de un AWS::Route53::RecordSetGroup AliasTarget recurso.

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

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

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

HostedZoneId

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

Especifica 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

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la HostedZoneId propiedad de un AWS::Route53::RecordSetGroup RecordSet recurso.

HostedZoneName

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

Especifica 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

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la HostedZoneName propiedad de un AWS::Route53::RecordSetGroup RecordSet recurso.

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

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

Region

Solo conjuntos de registros de recursos basados en la latencia: la EC2 región de Amazon en la que creó el recurso al que hace referencia este conjunto de registros de recursos. El recurso suele ser un AWS recurso, como una EC2 instancia o un balanceador de cargas ELB, y se hace referencia a él mediante una dirección IP o un nombre de dominio DNS, según el tipo de registro.

Cuando Amazon Route 53 recibe una consulta de DNS para un nombre y un tipo de dominio para los que ha creado conjuntos de registros de recursos de latencia, Route 53 selecciona el conjunto de registros de recursos de latencia que tiene la latencia más baja entre el usuario final y la EC2 región de Amazon 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 puedes crear un conjunto de registros de recursos de latencia para cada EC2 región de Amazon.

• No es necesario que crees conjuntos de registros de recursos de latencia para todas las EC2 regiones de Amazon. 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

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Region propiedad de un tipo de AWS::Route53::RecordSetGroup RecordSet datos.

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, consulta Elección de una política de direccionamiento en la Guía para desarrolladores de Amazon Route 53.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la SetIdentifier propiedad de un tipo de AWS::Route53::RecordSetGroup RecordSet datos.

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