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

# 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 位址類型優點的詳細資訊，請參閱 [AWS 上的 IPv6](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 位址類型。