Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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:StringEvaluateTargetHealth:BooleanHostedZoneId:StringHostedZoneName:StringIpV6:BooleanRegion:StringSetIdentifier:StringVpcEndpointDomainName:StringVpcEndpointHostedZoneId:String
Eigenschaften
-
DistributionDomainName -
Konfiguriert eine benutzerdefinierte Verteilung des benutzerdefinierten API-Domänennamens.
Typ: Zeichenfolge
Required: No
Standard: Verwenden Sie die API Gateway Gateway-Distribution.
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
DNSNameEigenschaft einerAWS::Route53::RecordSetGroup AliasTargetRessource übergeben.Zusätzliche Hinweise: Der Domainname einer CloudFrontDistribution.
-
EvaluateTargetHealth -
Wenn EvaluateTargetHealth wahr, erbt ein Aliaseintrag den Zustand der referenzierten AWS Ressource, z. B. eines Elastic Load Balancing Balancing-Load Balancers oder eines anderen Datensatzes in der Hosting-Zone.
Typ: Boolesch
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
EvaluateTargetHealthEigenschaft einerAWS::Route53::RecordSetGroup AliasTargetRessource übergeben.Zusätzliche Hinweise: Sie können den Wert nicht auf „true“ EvaluateTargetHealth setzen, wenn es sich bei dem Alias-Ziel um eine CloudFront Distribution handelt.
-
HostedZoneId -
Die ID der gehosteten Zone, in der Sie Datensätze erstellen möchten.
Geben Sie
HostedZoneNameoderHostedZoneIdan, jedoch nicht beides. Wenn Sie mehrere gehostete Zonen mit dem gleichen Domainnamen haben, müssen Sie die gehostete Zone mit derHostedZoneIdangeben.Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
HostedZoneIdEigenschaft einerAWS::Route53::RecordSetGroup RecordSetRessource übergeben. -
HostedZoneName -
Der Name der gehosteten Zone, in der Sie Datensätze erstellen möchten.
Geben Sie
HostedZoneNameoderHostedZoneIdan, jedoch nicht beides. Wenn Sie mehrere gehostete Zonen mit dem gleichen Domainnamen haben, müssen Sie die gehostete Zone mit derHostedZoneIdangeben.Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
HostedZoneNameEigenschaft einerAWS::Route53::RecordSetGroup RecordSetRessource übergeben. -
IpV6 -
Wenn diese Eigenschaft gesetzt ist, wird eine
AWS::Route53::RecordSetRessource AWS SAM erstellt und TypeAAAAfür die angegebene Ressource auf gesetzt HostedZone.Typ: Boolesch
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.
Region-
Nur latenzbasierte Ressourcendatensätze: Die EC2 Amazon-Region, in der Sie die Ressource erstellt haben, auf die sich dieser Ressourcendatensatz bezieht. Bei der Ressource handelt es sich in der Regel um eine AWS Ressource, z. B. eine EC2 Instance oder einen ELB-Load Balancer, auf die je nach Datensatztyp mit einer IP-Adresse oder einem DNS-Domainnamen verwiesen wird.
Wenn Amazon Route 53 eine DNS-Abfrage für einen Domainnamen und einen Domain-Typ empfängt, für den Sie Latenzressourcendatensätze erstellt haben, wählt Route 53 den Latenzressourcendatensatz aus, der die niedrigste Latenz zwischen dem Endbenutzer und der zugehörigen EC2 Amazon-Region aufweist. Route 53 gibt dann den Wert zurück, der dem ausgewählten Ressourcendatensatz zugeordnet ist.
Beachten Sie Folgendes:
-
Sie können nur einen
ResourceRecordpro Latenz-Ressourcendatensatz angeben. -
Sie können nur einen Latenzressourcendatensatz für jede EC2 Amazon-Region erstellen.
-
Sie müssen keine Latenzressourcendatensätze für alle EC2 Amazon-Regionen 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
NameundTypehaben wie Latenz-Ressourcendatensätze.
Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
RegionEigenschaft einesAWS::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
SetIdentifierfür jeden Ressourcen-Datensatz eindeutig sein.Informationen zu Routing-Richtlinien finden Sie unter Auswahl einer Routing-Richtlinie im Amazon Route 53-Entwicklerhandbuch.
Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
SetIdentifierEigenschaft einesAWS::Route53::RecordSetGroupRecordSetDatentyps übergeben. VpcEndpointDomainName-
Ein DNS-Name des VPC-Schnittstellenendpunkts, der dem API Gateway VPC-Dienst zugeordnet ist. Diese Eigenschaft ist nur für private Domänen erforderlich.
Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
DNSNameEigenschaft einesAWS::Route53::RecordSetAliasTargetFeldes übergeben. VpcEndpointHostedZoneId-
Die Hosting-Zonen-ID des VPC-Schnittstellenendpunkts, der dem API Gateway VPC-Dienst zugeordnet ist. Diese Eigenschaft ist nur für private Domänen erforderlich.
Typ: Zeichenfolge
Required: No
CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
HostedZoneIdEigenschaft einesAWS::Route53::RecordSetAliasTargetFeldes übergeben.
Beispiele
Einfaches Beispiel
In diesem Beispiel konfigurieren wir eine benutzerdefinierte Domain und Route 53-Datensätze für unsere API.
YAML
Resources: MyApi: Type: AWS::Serverless::Api Properties: StageName: Prod Domain: DomainName:www.example.comCertificateArn:arn:aws:acm:us-east-1:123456789012:certificate/abcdef12-3456-7890-abcd-ef1234567890EndpointConfiguration: REGIONAL Route53: HostedZoneId:ABCDEFGHIJKLMNOP