HTTP API 自訂網域名稱的 IP 位址類型 - Amazon API Gateway
IP 位址類型的考量事項變更自訂網域名稱的 IP 位址類型

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

HTTP API 自訂網域名稱的 IP 位址類型

建立 API 時，您可以指定可調用網域的 IP 位址類型。您可以選擇 IPv4 來解析 IPv4 位址以調用網域，也可以選擇雙堆疊，以同時允許 IPv4 和 IPv6 位址調用您的網域。我們建議您將 IP 位址類型設定為雙堆疊，以緩解 IP 空間耗盡或用於安全狀態。如需雙堆疊 IP 位址類型優點的詳細資訊，請參閱 AWS 上的 IPv6。

IP 位址類型的考量事項

下列考量事項可能會影響您使用 IP 位址類型。

  • API Gateway 自訂網域名稱的預設 IP 位址類型為 IPv4。

  • 您的自訂網域名稱不需要針對所有與其對應的 API 使用相同 IP 位址類型。如果您停用預設 API 端點，則可能會影響呼叫方調用 API 的方式。

變更自訂網域名稱的 IP 位址類型

您可以藉由更新網域的端點組態來變更 IP 位址類型。您可以使用 AWS 管理主控台、AWS CLI、CloudFormation 或 AWS SDK 來更新網域的端點組態。

AWS 管理主控台
若要變更自訂網域名稱的 IP 位址類型

  1. 在以下網址登入 API Gateway 主控台：https://console.aws.amazon.com/apigateway。

  2. 選擇公有自訂網域名稱。

  3. 選擇端點組態。

  4. 針對 IP 位址類型，選取 IPv4 或雙堆疊。

  5. 選擇儲存。

AWS CLI

以下 update-domain-name 命令會將 API 更新為雙堆疊 IP 位址類型：

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

輸出將如下所示：

{
    "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": {}
}