Route53Configuration

Configure les ensembles d'enregistrements Route53 pour une API.

Syntaxe

Pour déclarer cette entité dans votre modèle AWS Serverless Application Model (AWS SAM), utilisez la syntaxe suivante :

YAML

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

Propriétés

DistributionDomainName

Configure une distribution personnalisée du nom de domaine personnalisé de l'API.

Type : chaîne

Obligatoire : non

Par défaut : utilisez la distribution API Gateway.

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété DNSName d'une ressource AWS::Route53::RecordSetGroup AliasTarget.

Remarques supplémentaires : nom de domaine d'une CloudFrontdistribution.

EvaluateTargetHealth

Lorsque cela EvaluateTargetHealth est vrai, un enregistrement d'alias hérite de l'état de la AWS ressource référencée, comme un équilibreur de charge Elastic Load Balancing ou un autre enregistrement de la zone hébergée.

Type : valeur booléenne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété EvaluateTargetHealth d'une ressource AWS::Route53::RecordSetGroup AliasTarget.

Remarques supplémentaires : vous ne pouvez pas EvaluateTargetHealth définir la valeur true lorsque l'alias cible est une CloudFront distribution.

HostedZoneId

ID de la zone hébergée dans laquelle vous souhaitez créer des enregistrements.

Spécifiez HostedZoneName ou HostedZoneId, mais pas les deux. Si plusieurs zones hébergées portent le même nom de domaine, vous devez spécifier la zone hébergée à l'aide de la valeur HostedZoneId.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété HostedZoneId d'une ressource AWS::Route53::RecordSetGroup RecordSet.

HostedZoneName

Nom de la zone hébergée dans laquelle vous souhaitez créer des enregistrements. Vous devez inclure un point de fin (par exemple, www.example.com.) dans le HostedZoneName.

Spécifiez HostedZoneName ou HostedZoneId, mais pas les deux. Si plusieurs zones hébergées portent le même nom de domaine, vous devez spécifier la zone hébergée à l'aide de la valeur HostedZoneId.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété HostedZoneName d'une ressource AWS::Route53::RecordSetGroup RecordSet.

IpV6

Lorsque cette propriété est définie, elle AWS SAM crée une AWS::Route53::RecordSet ressource et attribue à Type AAAA la valeur fournie HostedZone.

Type : valeur booléenne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est unique pour AWS SAM et ne dispose pas d'équivalent AWS CloudFormation.

Region

Ensembles d'enregistrements de ressource de latence uniquement : la région Amazon EC2 où vous avez créé la ressource à laquelle cet ensemble d'enregistrements de ressource fait référence. Généralement, il s'agit d'une ressource AWS, telle qu'une instance EC2 ou un équilibreur de charge ELB, qui est référencée par une adresse IP ou un nom de domaine DNS, en fonction du type d'enregistrement.

Lorsqu'Amazon Route 53 reçoit une requête DNS pour un nom de domaine et un type pour lequel vous avez créé des ensembles d'enregistrements de ressource de latence, Route 53 sélectionne l'ensemble d'enregistrements de ressource de latence dont la latence est la plus faible entre l'utilisateur final et la région Amazon EC2 associée. Route 53 renvoie ensuite la valeur associée à l'ensemble d'enregistrements de ressource sélectionné.

Notez ce qui suit :

• Vous pouvez uniquement spécifier un ResourceRecord par ensemble d'enregistrements de ressource de latence.

• Vous ne pouvez créer qu'un ensemble d'enregistrements de ressource de latence pour chaque région Amazon EC2.

• Vous n'êtes pas obligé de créer des ensembles d'enregistrements de ressource de latence pour toutes les régions Amazon EC2. Route 53 choisit la région dotée de la meilleure latence parmi les régions pour lesquelles vous créez des ensembles d'enregistrements de ressource de latence.

• Vous ne pouvez pas créer des ensembles d'enregistrements de ressource sans latence ayant les mêmes valeurs pour les éléments Name et Type que celles des ensembles d'enregistrements de ressource de latence.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété Region d'un type de données AWS::Route53::RecordSetGroup RecordSet.

SetIdentifier

Ensembles d'enregistrements de ressource ayant une politique de routage autre que simple : un identificateur qui se différencie parmi plusieurs ensembles d'enregistrements de ressource ayant la même combinaison de nom et de type, comme plusieurs ensembles d'enregistrements de ressource pondérés nommés acme.example.com ayant un type A. Dans un groupe d'ensembles d'enregistrements de ressource ayant les mêmes nom et type, la valeur SetIdentifier doit être unique pour chaque ensemble d'enregistrements de ressource.

Pour de plus amples informations sur les politiques de routage, veuillez consulter Choix d'une politique de routage dans le Guide du développeur Amazon Route 53.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété SetIdentifier d'un type de données AWS::Route53::RecordSetGroup RecordSet.

Exemples

Exemple de configuration Route 53

Cet exemple montre comment configurer Route 53.

YAML

Domain:
  DomainName: www.example.com
  CertificateArn: arn-example
  EndpointConfiguration: EDGE
  Route53:
    HostedZoneId: Z1PA6795UKMFR9
    EvaluateTargetHealth: true
    DistributionDomainName: xyz