在 API Gateway 中透過您的自訂網域名稱將流量傳送至 API
當您為自訂網域名稱設定路由模式時,您會設定傳入流量導向 API 的方式。您會使用路由規則、API 映射,或是路由規則與 API 映射,將流量傳送至您的 API。下節說明何時使用路由規則、何時使用 API 映射,以及如何為您的自訂網域名稱設定路由模式。
何時使用路由規則
當您使用路由規則時,您會將符合特定條件的傳入請求導向特定 REST API 階段。例如,如果規則包含標頭 version:v1
和基本路徑 /users
,則可將請求路由至 users
REST API 的 production
階段。使用路由規則來建立進階動態路由拓撲,以支援如 A/B 測試等使用案例,或增加新版 API 的使用率。
建議您將流量導向 REST API 時,針對自訂網域名稱使用路由規則。您可以使用路由規則重新建立任何 API 映射。如需更多詳細資訊,請參閱 使用路由規則重新建立 API 映射。
對於 REST API,您也可以同時使用路由規則和 API 映射。若您同時使用路由規則和 API 映射,則 API Gateway 一律會先評估路由規則,再評估任何 API 映射。同時使用路由規則和 API 映射來移轉您目前的自訂網域名稱,或探索路由規則。
路由規則的考量事項
下列考量事項可能會影響您使用路由規則:
-
不支援使用 WebSocket 或 HTTP API 作為路由規則的目標 API。
-
如果您的自訂網域名稱同時具有 REST 和 HTTP API 的 API 映射,則不支援路由規則。
-
您可以建立私有自訂網域至私有 REST API 的路由規則。您可以建立公有自訂網域至區域或邊緣最佳化 API 的路由規則。
-
您無法建立公有自訂網域至私有 API 的路由規則。您無法建立私有自訂網域名稱至公有 API 的路由規則。
選擇路由規則或是 API 映射
建議您盡可能使用路由規則。只有在將流量傳送至 HTTP 或 WebSocket API 時才使用 API 映射。