# API Gateway 中 REST API 的 IP 地址类型
<a name="api-gateway-ip-address-type"></a>

创建 API 时，您指定可以调用您的 API 的 IP 地址的类型。可以选择 IPv4 来解析 IPv4 地址以调用 API，也可以选择双堆栈以同时支持 IPv4 和 IPv6 地址调用 API。我们建议您将 IP 地址类型设置为双堆栈，以缓解 IP 空间耗尽或保护您的安全状况。有关双堆栈 IP 地址类型的优势的更多信息，请参阅 [IPv6 on AWS](https://docs.aws.amazon.com/whitepapers/latest/ipv6-on-aws/internet-protocol-version-6.html)。

要将 API 限制为仅限 IPv6 流量，您可以创建资源策略，并将源 IP 地址限制为仅限 IPv6 范围。您可以通过更新 API 的配置来更改 IP 地址类型。此更改将立即生效，而您无需重新部署 API。有关更多信息，请参阅 [示例：基于源 IP 地址或范围拒绝 API 流量](apigateway-resource-policies-examples.md#apigateway-resource-policies-source-ip-address-example)。

## IP 地址类型的注意事项
<a name="api-gateway-ip-address-type-considerations"></a>

以下注意事项可能会影响您对 IP 地址类型的使用：
+ 所有区域和边缘优化 API 的默认 IP 地址类型均为 IPv4。
+ 私有 API 只能具有双堆栈 IP 地址类型。
+ 如果您将现有 API 的 IP 地址类型从 IPv4 更改为双堆栈，请确认任何控制 API 访问权限的策略均已更新以考虑 IPv6 调用。更改 IP 地址类型后，更改将立即生效。
+ 如果您将 API 的端点类型从区域或边缘优化迁移到私有，API Gateway 会将 IP 地址类型更改为双堆栈。有关更多信息，请参阅 [在 API Gateway 中更改公有或私有 API 端点类型](apigateway-api-migration.md)。
+ 如果您将 API 的端点类型从私有迁移到区域，则必须将 IP 地址类型设置为双堆栈。端点迁移完成后，您可以将 IP 地址类型更改为 IPv4。有关更多信息，请参阅 [在 API Gateway 中更改公有或私有 API 端点类型](apigateway-api-migration.md)。
+ 您的 API 可以映射到与 API 具有不同 IP 地址类型的自定义域名。如果您禁用默认 API 端点，则这可能会影响调用方调用 API 的方式。
+ 您不能使用外部定义文件来配置 API 的 IP 地址类型。