Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
API Gateway 中 HTTP API 的 IP 地址类型
创建 API 时，您指定可以调用您的 API 的 IP 地址的类型。可以选择 IPv4 来解析 IPv4 地址以调用 API，也可以选择双堆栈以同时支持 IPv4 和 IPv6 地址调用 API。您可能需要将 IP 地址类型设置为双堆栈，以缓解 IP 空间耗尽或保护您的安全状况。有关双堆栈 IP 地址类型的优势的更多信息，请参阅 IPv6 on Amazon。
IP 地址类型的注意事项
以下注意事项可能会影响您对 IP 地址类型的使用：
-
HTTP API 的默认 IP 地址类型是 IPv4。
-
如果您将现有 API 的 IP 地址类型从 IPv4 更改为双堆栈，请确认任何控制 API 访问权限的策略均已更新以考虑 IPv6 调用。更改 IP 地址类型后，更改将立即生效。
-
您的 API 可以映射到与 API 具有不同 IP 地址类型的自定义域名。如果您禁用默认 API 端点，则这可能会影响调用方调用 API 的方式。
更改 HTTP API 的 IP 地址类型
您可以通过更新 API 的配置来更改 IP 地址类型。您可以使用 Amazon Web Services 管理控制台、Amazon CLI、Amazon CloudFormation 或 Amazon SDK 更新 API 的配置。如果您更改 API 的 IP 地址类型，您不需要重新部署 API 即可使更改生效。
- Amazon Web Services 管理控制台
-
- Amazon CLI
-
以下 update-api 命令将 API 更新为具有双堆栈 IP 地址类型：
aws apigatewayv2 update-api \
--api-id abcd1234 \
--ip-address-type dualstack
输出将与以下内容类似：
{
"ApiEndpoint": "https://abcd1234.execute-api.us-east-1.amazonaws.com",
"ApiId": "abcd1234",
"ApiKeySelectionExpression": "$request.header.x-api-key",
"CreatedDate": "2025-02-04T22:20:20+00:00",
"DisableExecuteApiEndpoint": false,
"Name": "My-HTTP-API",
"ProtocolType": "HTTP",
"RouteSelectionExpression": "$request.method $request.path",
"Tags": {},
"NotificationUris": [],
"IpAddressType": "dualstack"
}