IP-Adresstypen für benutzerdefinierte Domainnamen für HTTP-APIs - Amazon API Gateway
Überlegungen zu IP-AdresstypenÄndern des IP-Adresstyps eines benutzerdefinierten Domainnamens

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.

IP-Adresstypen für benutzerdefinierte Domainnamen für HTTP-APIs

Beim Erstellen einer API geben Sie den Typ der IP-Adressen an, die Ihre Domain aufrufen können. Sie können IPv4 auswählen, um IPv4-Adressen für den Aufruf Ihrer Domain zuzulassen, oder Dualstack, um sowohl IPv4- als auch IPv6-Adressen für den Aufruf zuzulassen. Wir empfehlen, den IP-Adresstyp auf Dualstack zu setzen, um Engpässe im IP-Adressraum zu vermeiden und Ihre Sicherheitsposition zu verbessern. Weitere Informationen zu den Vorteilen eines Dualstack-IP-Adresstyps finden Sie unter IPv6 in AWS.

Überlegungen zu IP-Adresstypen

Die folgenden Überlegungen können Ihre Verwendung von IP-Adresstypen beeinflussen.

  • Der Standard-IP-Adresstyp für benutzerdefinierte Domainnamen in API Gateway ist IPv4.

  • Ihr benutzerdefinierter Domainname muss nicht denselben IP-Adresstyp für alle darauf zugewiesenen APIs haben. Wenn Sie Ihren Standard-API-Endpunkt deaktivieren, kann dies die Art und Weise beeinflussen, wie Aufrufer Ihre API aufrufen können.

Ändern des IP-Adresstyps eines benutzerdefinierten Domainnamens

Sie können den IP-Adresstyp ändern, indem Sie die Endpunktkonfiguration der Domain aktualisieren. Dies kann über die AWS-Managementkonsole, die AWS CLI, CloudFormation oder ein AWS SDK erfolgen.

AWS-Managementkonsole
So ändern Sie den IP-Adresstyp eines benutzerdefinierten Domainnamens

  1. Melden Sie sich bei der API Gateway-Konsole unter https://console.aws.amazon.com/apigateway an.

  2. Wählen Sie einen öffentlichen benutzerdefinierten Domainnamen aus.

  3. Wählen Sie Endpunktkonfiguration aus.

  4. Wählen Sie unter „IP-Adresstyp“ entweder IPv4 oder Dualstack aus.

  5. Wählen Sie Speichern aus.

AWS CLI

Der folgende update-domain-name-Befehl aktualisiert eine API, sodass sie den IP-Adresstyp „Dualstack“ aufweist:

aws apigatewayv2 update-domain-name \
   --domain-name dualstack.example.com \
   --domain-name-configurations CertificateArn=arn:aws:acm:us-east-1:111122223333:certificate/abcd1234-5678-abc,IpAddressType=dualstack

Die Ausgabe sieht wie folgt aus:

{
    "ApiMappingSelectionExpression": "$request.basepath",
    "DomainName": "dualstack.example.com",
    "DomainNameConfigurations": [
        {
            "ApiGatewayDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com",
            "CertificateArn": "arn:aws:acm:us-east-1:111122223333:certificate/abcd1234-5678-abc",
            "DomainNameStatus": "AVAILABLE",
            "EndpointType": "REGIONAL",
            "HostedZoneId": "Z3LQWSYCGH4ADY",
            "SecurityPolicy": "TLS_1_2",
            "IpAddressType": "dualstack"
        }
    ],
    "Tags": {}
}