API Gateway 中 REST API 的 IP 位址類型 - Amazon API Gateway

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

API Gateway 中 REST API 的 IP 位址類型

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

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

IP 位址類型的考量事項

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

  • 所有區域和邊緣最佳化 API 的預設 IP 位址類型都是 IPv4。

  • 私有 API 只能具有雙堆疊 IP 位址類型。

  • 如果您將現有 API 的 IP 位址類型從 IPv4 變更為雙堆疊,請確認控制存取 API 的任何政策都已更新,以便進行 IPv6 呼叫。當您變更 IP 位址類型時,變更會立即生效。

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

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

  • 您的 API 可以對應至與您的 API 具有不同 IP 位址類型的自訂網域名稱。如果您停用預設 API 端點,則可能會影響呼叫方調用 API 的方式。

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