API Gateway 中 REST APIs IP 地址類型 - Amazon API Gateway

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

API Gateway 中 REST APIs IP 地址類型

建立 API 時,您可以指定可叫用 API 的 IP 地址類型。您可以選擇 IPv4 以允許 IPv4 地址調用您的 API,也可以選擇雙堆疊以允許 IPv4 和 IPv6 地址調用您的 API。建議您將 IP 地址類型設定為 dualstack,以減輕 IP 空間耗盡或用於安全狀態。如需雙堆疊 IP 地址類型優點的詳細資訊,請參閱 上的 IPv6 AWS

若要將您的 API 限制為僅 IPv6 流量,您可以建立資源政策,並將來源 IP 地址限制為僅 IPv6 範圍。您可以更新 API 的組態來變更 IP 地址類型。此變更會立即生效,而且您不需要重新部署 API。如需詳細資訊,請參閱範例:拒絕根據來源 IP 地址或範圍的 API 流量

IP 地址類型的考量

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

  • 所有區域和邊緣最佳化 APIs 的預設 IP 地址類型為 IPv4。

  • 私有 APIs只能具有雙堆疊 IP 地址類型。

  • 如果您將現有 API 的 IP 地址類型從 IPv4 變更為 dualstack,請確認控制存取 APIs的任何政策都已更新,以說明 IPv6 呼叫。當您變更 IP 地址類型時,變更會立即生效。

  • 如果您將 API 的端點類型從區域或邊緣最佳化遷移至私有,API Gateway 會將 IP 地址類型變更為 dualstack。如需詳細資訊,請參閱在 API Gateway 中變更公有或私有 API 端點類型

  • 如果您將 API 的端點類型從私有遷移至區域,則必須將 IP 地址類型設定為 dualstack。端點遷移完成後,您可以將 IP 地址類型變更為 IPv4。如需詳細資訊,請參閱在 API Gateway 中變更公有或私有 API 端點類型

  • 您的 API 可以映射到與 API 不同的 IP 地址類型的自訂網域名稱。如果您停用預設 API 端點,這可能會影響呼叫者呼叫 API 的方式。

  • 您無法使用外部定義檔案來設定 API 的 IP 地址類型。