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.
Configura los conjuntos de registros de Route53 para una API.
Sintaxis
Para declarar esta entidad en tu plantilla de 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.
Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad
DNSName
de un recursoAWS::Route53::RecordSetGroup AliasTarget
.Notas adicionales: el nombre de dominio de una distribución de CloudFront.
-
EvaluateTargetHealth
-
Cuando EvaluateTargetHealth es true, un registro de alias hereda el estado del recurso de AWS al que se hace referencia; por ejemplo, un equilibrador de carga de Elastic Load Load Balancing u otro registro en la zona alojada.
Tipo: Booleano
Obligatorio: no
Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad
EvaluateTargetHealth
de un recursoAWS::Route53::RecordSetGroup AliasTarget
.Notas adicionales: no puedes establecer EvaluateTargetHealth (Evaluar estado del destino) en true cuando el alias de destino es una distribución de CloudFront.
-
HostedZoneId
-
ID de la zona alojada en la que desea crear registros.
Especifica
HostedZoneName
oHostedZoneId
, pero no ambos. Si tiene múltiples zonas hospedadas con el mismo nombre de dominio, debe especificar la zona hospedada medianteHostedZoneId
.Tipo: cadena
Obligatorio: no
Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad
HostedZoneId
de un recursoAWS::Route53::RecordSetGroup RecordSet
. -
HostedZoneName
-
El nombre de la zona alojada en la que desea crear registros.
Especifica
HostedZoneName
oHostedZoneId
, pero no ambos. Si tiene múltiples zonas hospedadas con el mismo nombre de dominio, debe especificar la zona hospedada medianteHostedZoneId
.Tipo: cadena
Obligatorio: no
Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad
HostedZoneName
de un recursoAWS::Route53::RecordSetGroup RecordSet
. -
IpV6
-
Cuando se establece esta propiedad, AWS SAM crea un recurso
AWS::Route53::RecordSet
y establece Tipo enAAAA
para la HostedZone proporcionada.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
yType
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 datosRecordSet
deAWS::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, consulta 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 datosRecordSet
deAWS::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