View a markdown version of this page

Route53Configuration - AWS Serverless Application Model
SyntaxePropriétésExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

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

Propriétés

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

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

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

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

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

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

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

CloudFormation compatibilité : cette propriété est unique AWS SAM et n'a pas d' CloudFormation équivalent.

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. La ressource est généralement une AWS ressource, telle qu'une instance EC2 ou un équilibreur de charge ELB, à laquelle il est fait référence par une adresse IP ou un nom de domaine DNS, selon le 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

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

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

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

Exemples

Exemple de configuration Route 53

Cet exemple montre comment configurer Route 53.

YAML

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