Configura un nome di dominio personalizzato regionale in API Gateway

Il create-domain-namecomando seguente può essere utilizzato per creare un nome di dominio personalizzato:

aws apigatewayv2 create-domain-name \ 
    --domain-name 'regional.example.com' \
    --domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678

Se l'operazione va a buon fine, la risposta alla chiamata presenta un risultato simile al seguente:

{
    "ApiMappingSelectionExpression": "$request.basepath",
    "DomainName": "regional.example.com",
    "DomainNameConfigurations": [
        {
            "ApiGatewayDomainName": "d-numh1z56v6.execute-api.us-west-2.amazonaws.com",
            "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
            "DomainNameStatus": "AVAILABLE",
            "EndpointType": "REGIONAL",
            "HostedZoneId": "Z2OJLYMUO9EFXC",
            "SecurityPolicy": "TLS_1_2"
        }
    ]
}

Il valore della DomainNameConfigurations proprietà restituisce il nome host API del Regional. È necessario creare un DNS record per indirizzare il nome di dominio personalizzato a questo nome di dominio regionale. Ciò consente al traffico associato al nome di dominio personalizzato di essere indirizzato al nome host API di questa regione.

Per utilizzare il AWS Management Console, segui la documentazione di Route 53 sulla configurazione di Route 53 per instradare il traffico verso API Gateway.

Per configurare i DNS record in modo da mappare il nome di dominio personalizzato regionale al nome host dell'ID della zona ospitata specificato, crea innanzitutto un JSON file che contenga la configurazione per l'impostazione di un DNS record per il nome di dominio regionale.

Di seguito setup-dns-record.json viene illustrato come creare un DNS A record per mappare un nome di dominio personalizzato regionale (regional.example.com) al relativo hostname regionale (d-numh1z56v6.execute-api.us-west-2.amazonaws.com) fornito come parte della creazione del nome di dominio personalizzato. Le proprietà DNSName e HostedZoneId di AliasTarget possono prendere rispettivamente i valori regionalDomainName e regionalHostedZoneId del nome di dominio personalizzato. Puoi anche ottenere la Regional Route 53 Hosted Zone IDs in Amazon API Gateway Endpoints and Quotas.

{
  "Changes": [
    {
      "Action": "CREATE",
      "ResourceRecordSet": {
        "Name": "regional.example.com",
        "Type": "A",
        "AliasTarget": {
          "DNSName": "d-numh1z56v6.execute-api.us-west-2.amazonaws.com",
          "HostedZoneId": "Z2OJLYMUO9EFXC",
          "EvaluateTargetHealth": false
        }
      }
    }
  ]
}

Di seguito change-resource-record-setsviene illustrato come creare un DNS record per il nome di dominio personalizzato regionale:

aws route53 change-resource-record-sets \
    --hosted-zone-id Z2OJLYMUO9EFXC \
    --change-batch file://path/to/your/setup-dns-record.json

hosted-zone-idSostituiscilo con l'ID della zona ospitata Route 53 del DNS record impostato nel tuo account. Il valore del change-batch parametro punta a un JSON file (setup-dns-record.json) in una cartella (path/to/your).

Il create-api-mappingcomando seguente può essere usato per creare una mappatura del percorso di base:

aws apigatewayv2 create-api-mapping \
    --domain-name 'regional.example.com' \
    --api-mapping-key 'myApi' \
    --api-id abcd1234 \
    --stage 'test'

Di conseguenza, la base che URL utilizza il nome di dominio personalizzato per il API che viene distribuito nella fase diventa. https://regional.example.com/myAPI