Route53Configuration

Konfiguriert die Route53-Datensätze für eine API.

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer AWS Serverless Application Model (AWS SAM)-Vorlage zu deklarieren.

YAML

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

Eigenschaften

DistributionDomainName

Konfiguriert eine benutzerdefinierte Verteilung des benutzerdefinierten API-Domänennamens.

Typ: Zeichenfolge

Required: No

Standard: Verwenden Sie die API Gateway-Verteilung.

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -DNSNameEigenschaft einer -AWS::Route53::RecordSetGroup AliasTargetRessource übergeben.

Zusätzliche Hinweise: Der Domänenname einer CloudFront Verteilung.

EvaluateTargetHealth

Wenn „true“ EvaluateTargetHealth ist, erbt ein Alias-Datensatz den Zustand der referenzierten AWS Ressource, z. B. einen Elastic Load Balancing Load Balancer oder einen anderen Datensatz in der gehosteten Zone.

Typ: Boolesch

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -EvaluateTargetHealthEigenschaft einer -AWS::Route53::RecordSetGroup AliasTargetRessource übergeben.

Zusätzliche Hinweise: Sie können nicht EvaluateTargetHealth auf „true“ setzen, wenn das Aliasziel eine CloudFront Verteilung ist.

HostedZoneId

Die ID der gehosteten Zone, in der Sie Datensätze erstellen möchten.

Geben Sie HostedZoneName oder HostedZoneId an, jedoch nicht beides. Wenn Sie mehrere gehostete Zonen mit dem gleichen Domainnamen haben, müssen Sie die gehostete Zone mit der HostedZoneId angeben.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -HostedZoneIdEigenschaft einer -AWS::Route53::RecordSetGroup RecordSetRessource übergeben.

HostedZoneName

Der Name der gehosteten Zone, in der Sie Datensätze erstellen möchten. Sie müssen einen abschließenden Punkt (z. B. www.example.com.) als Teil des HostedZoneName angeben.

Geben Sie HostedZoneName oder HostedZoneId an, jedoch nicht beides. Wenn Sie mehrere gehostete Zonen mit dem gleichen Domainnamen haben, müssen Sie die gehostete Zone mit der HostedZoneId angeben.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -HostedZoneNameEigenschaft einer -AWS::Route53::RecordSetGroup RecordSetRessource übergeben.

IpV6

Wenn diese Eigenschaft festgelegt ist, AWS SAM erstellt eine -AWS::Route53::RecordSetRessource und setzt Typ AAAA für das bereitgestellte auf HostedZone.

Typ: Boolesch

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft ist eindeutig für AWS SAM und hat kein AWS CloudFormationÄquivalent.

Region

Nur latenzbasierte Ressourcendatensätze: Die Amazon EC2-Region, in der Sie die Ressource erstellt haben, auf die sich dieser Ressourcendatensatz bezieht. Die Ressource ist typischerweise eine AWS-Ressource, wie z. B. eine EC2-Instance oder ein ELB-Load-Balancer, und wird je nach Datensatztyp durch eine IP-Adresse oder einen DNS-Domainnamen bezeichnet.

Wenn Amazon Route 53 eine DNS-Abfrage nach einem Domainnamen und -typ erhält, für den Sie Latenzressourcen-Datensätze erstellt haben, wählt Route 53 den Latenzressourcen-Datensatz aus, der die niedrigste Latenzzeit zwischen dem Endbenutzer und der zugehörigen Amazon EC2-Region aufweist.Input Route 53 gibt dann den Wert zurück, der dem ausgewählten Ressourcendatensatz zugeordnet ist.

Beachten Sie Folgendes:

• Sie können nur einen ResourceRecord pro Latenz-Ressourcendatensatz angeben.

• Sie können nur einen Latenz-Ressourcendatensatz für jede Amazon EC2-Region erstellen.

• Sie sind nicht verpflichtet, Latenz-Ressourcendatensätze für alle Amazon EC2-Regionen zu erstellen. Route 53 wählt die Region mit der besten Latenz aus den Regionen aus, für die Sie Latenz-Ressourcendatensätze erstellen.

• Sie können keine Nicht-Latenz-Ressourcendatensätze erstellen, die die gleichen Werte für die Elemente Name und Type haben wie Latenz-Ressourcendatensätze.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die - RegionEigenschaft eines -AWS::Route53::RecordSetGroupRecordSetDatentyps übergeben.

SetIdentifier

Ressourcendatensätze, die eine andere Routing-Richtlinie als "einfach" haben: Ein Bezeichner, der zwischen mehreren Ressourcendatensätzen unterscheidet, die die gleiche Kombination aus Name und Typ haben, wie beispielsweise mehrere gewichtete Ressourcendatensätze namens acme.example.com, die einen Typ A haben. In einer Gruppe von Ressourcendatensätzen, die den gleichen Namen und Typ haben, muss der Wert von SetIdentifier für jeden Ressourcen-Datensatz eindeutig sein.

Weitere Informationen zu Routing-Richtlinien finden Sie unter Auswählen einer Routing-Richtlinie im Amazon Route 53-Entwicklerhandbuch.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die - SetIdentifierEigenschaft eines -AWS::Route53::RecordSetGroupRecordSetDatentyps übergeben.

Beispiele

Beispiel für Route 53-Konfiguration

Dieses Beispiel zeigt, wie Route 53 konfiguriert wird.

YAML

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