API Gateway 中自定义域名的 IP 地址类型 - Amazon API Gateway
IP 地址类型的注意事项更改自定义域名的 IP 地址类型
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

API Gateway 中自定义域名的 IP 地址类型

当您创建自定义域名时，您指定可以调用域的 IP 地址的类型。可以选择 IPv4 以解析 IPv4 地址来调用域，也可以选择双堆栈以同时支持 IPv4 和 IPv6 地址调用域。我们建议您将 IP 地址类型设置为双堆栈，以缓解 IP 空间耗尽或保护您的安全状况。有关双堆栈 IP 地址类型的优势的更多信息，请参阅 IPv6 on Amazon。

您可以通过更新域名的端点配置来更改 IP 地址类型。

IP 地址类型的注意事项

以下注意事项可能会影响您对 IP 地址类型的使用。

  • 公有 API 的 API Gateway 自定义域名的默认 IP 地址类型是 IPv4。

  • 私有自定义域名只能具有双堆栈 IP 地址类型。

  • 对于映射到自定义域名的所有 API，自定义域名不需要具有相同的 IP 地址类型。如果您禁用默认 API 端点，则这可能会影响调用方调用域的方式。

更改自定义域名的 IP 地址类型

您可以通过更新域名的端点配置来更改 IP 地址类型。您可以使用 Amazon Web Services Management Console、Amazon CLI、Amazon CloudFormation 或 Amazon SDK 更新端点配置。

Amazon Web Services Management Console
更改自定义域名的 IP 地址类型

  1. 通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

  2. 选择公有自定义域名。

  3. 选择端点配置。

  4. 对于 IP 地址类型，选择 IPv4 或双堆栈。

  5. 选择保存。

Amazon CLI

以下 update-domain-name 命令将 API 更新为具有双堆栈 IP 地址类型：

aws apigateway update-domain-name \
    --domain-name dualstack.example.com \
    --patch-operations "op='replace',path='/endpointConfiguration/ipAddressType',value='dualstack'"

输出将与以下内容类似：

{
    "domainName": "dualstack.example.com",
    "certificateUploadDate": "2025-02-04T14:46:10-08:00",
    "regionalDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com",
    "regionalHostedZoneId": "Z3LQWSYCGH4ADY",
    "regionalCertificateArn": "arn:aws:acm:us-east-1:111122223333:certificate/a1b2c3d4-5678-90ab-cdef",
    "endpointConfiguration": {
        "types": [
            "REGIONAL"
        ],
        "ipAddressType": "dualstack"
    },
    "domainNameStatus": "AVAILABLE",
    "securityPolicy": "TLS_1_2",
    "tags": {}
}