Route53Configuration

Configura i set di record Route53 per un'API.

Sintassi

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

YAML

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

Proprietà

DistributionDomainName

Configura una distribuzione personalizzata del nome di dominio personalizzato dell'API.

Tipo: stringa

Required: No

Impostazione predefinita: utilizza la distribuzione API Gateway.

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla DNSName proprietà di una AWS::Route53::RecordSetGroup AliasTarget risorsa.

Note aggiuntive: il nome di dominio di una CloudFrontdistribuzione.

EvaluateTargetHealth

Quando EvaluateTargetHealth è vero, un record alias eredita lo stato della AWS risorsa di riferimento, ad esempio un sistema di bilanciamento del carico Elastic Load Balancing o un altro record nella zona ospitata.

Tipo: Booleano

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla proprietà di una risorsa. EvaluateTargetHealth AWS::Route53::RecordSetGroup AliasTarget

Note aggiuntive: non è possibile impostare su EvaluateTargetHealth true quando l'alias target è una CloudFront distribuzione.

HostedZoneId

L'ID della zona ospitata in cui creare i record.

Specifica HostedZoneName o HostedZoneId, ma non entrambi. Se disponi di più zone ospitate con lo stesso nome di dominio, devi specificare la zona ospitata utilizzando HostedZoneId.

Tipo: stringa

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla HostedZoneId proprietà di una AWS::Route53::RecordSetGroup RecordSet risorsa.

HostedZoneName

Il nome della zona ospitata in cui desideri creare record.

Specifica HostedZoneName o HostedZoneId, ma non entrambi. Se disponi di più zone ospitate con lo stesso nome di dominio, devi specificare la zona ospitata utilizzando HostedZoneId.

Tipo: stringa

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla HostedZoneName proprietà di una AWS::Route53::RecordSetGroup RecordSet risorsa.

IpV6

Quando questa proprietà è impostata, AWS SAM crea una AWS::Route53::RecordSet risorsa e imposta Type su AAAA quella fornita HostedZone.

Tipo: Booleano

Required: No

AWS CloudFormationcompatibilità: questa proprietà è unica AWS SAM e non ha un AWS CloudFormation equivalente.

Region

Solo set di record di risorse basati sulla latenza: la Regione Amazon EC2 in cui hai creato la risorsa a cui fa riferimento il set di record di risorse specificato. In genere, la risorsa è una risorsa AWS, ad esempio un'istanza EC2 o un load balancer ELB, a cui viene fatto riferimento mediante un indirizzo IP o un nome di dominio DNS, a seconda del tipo di record.

Quando Amazon Route 53 riceve una query DNS per un nome e un tipo di dominio per cui hai creato i set di record di risorse di latenza, Route 53 seleziona il set di record di risorse di latenza che ha la latenza più bassa tra l'utente finale e la relativa Regione Amazon EC2. Route 53 restituisce il valore associato al set di record della risorsa selezionato.

Tieni presente quanto segue:

• È possibile specificare un ResourceRecord per set di record di risorse di latenza.

• Si può creare un solo set di record di risorse di latenza per ciascuna Regione Amazon EC2.

• Non è obbligatorio creare set di record di risorse di latenza per tutte le Regioni Amazon EC2. Route 53 sceglie la Regione con la migliore latenza tra quelle per cui hai creato i set di record della risorsa di latenza.

• Non è possibile creare set di record di risorse non di latenza le cui proprietà Name e Type abbiano lo stesso valore dei set di record di risorse di latenza.

Tipo: stringa

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla Region proprietà di un tipo di AWS::Route53::RecordSetGroup RecordSet dati.

SetIdentifier

Set di record di risorse con un criterio di routing non semplice: un identificatore che differenzia tra più set di record di risorse che hanno la stessa combinazione di nome e tipo, ad esempio più set di record di risorse ponderati denominati acme.example.com di tipo A. In un gruppo di set di record di risorse con lo steso nome e lo stesso tipo, il valore di SetIdentifier deve essere univoco per ogni set di record di risorse.

Per informazioni sulle politiche di routing, consulta la sezione Choose a routing policy nella Amazon Route 53 Developer Guide.

Tipo: stringa

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla SetIdentifier proprietà di un tipo di AWS::Route53::RecordSetGroup RecordSet dati.

Esempi

Esempio di base

In questo esempio, configuriamo un dominio personalizzato e i set di record Route 53 per la nostra 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