透過 APIs中的自訂網域名稱,將流量傳送至您的 API - Amazon API Gateway

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

透過 APIs中的自訂網域名稱,將流量傳送至您的 API

當您為自訂網域名稱設定路由模式時,您可以設定傳入流量導向 APIs的方式。您可以使用路由規則、APIs 映射或路由規則和 API 映射,將流量傳送至您的 API。下一節說明何時使用路由規則、何時使用 API 映射,以及如何為您的自訂網域名稱設定路由模式。

何時使用路由規則

當您使用路由規則時,您可以將符合特定條件的傳入請求導向特定 REST APIs階段。例如,如果 包含 標頭version:v1和 基本路徑 ,則規則可以將請求路由到 users REST API 的 production階段/users。使用路由規則來建立進階動態路由拓撲,以支援使用案例,例如 A/B 測試或增加新版本的 APIs 用量。

建議您在將流量導向 REST API 時,使用自訂網域名稱的路由規則。您可以使用路由規則重新建立任何 API 映射。如需詳細資訊,請參閱使用路由規則重新建立 API 映射

對於 REST APIs,您也可以同時使用路由規則和 API 映射。當您同時使用路由規則和 API 映射時,API Gateway 一律會在評估任何 API 映射之前評估路由規則。同時使用路由規則和 API 映射來遷移您目前的自訂網域名稱或探索路由規則。

路由規則的考量事項

下列考量事項可能會影響您對路由規則的使用:

  • WebSocket 或 HTTP APIs 不支援做為路由規則的目標 APIs。

  • 如果您的自訂網域名稱同時具有與 REST 和 HTTP APIs API 映射,則不支援路由規則。

  • 您可以為私有自訂網域建立路由規則至私有 REST API。您可以為公有自訂網域建立路由規則至區域或邊緣最佳化 API。

  • 您無法為公有自訂網域建立路由規則至私有 API。您無法為私有自訂網域名稱建立路由規則至公有 API。

在路由規則和 API 映射之間進行選擇

我們建議您盡可能使用路由規則。僅使用 API 映射將流量傳送至 HTTP 或 WebSocket API。