

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

# 在 API Gateway 中透過您的自訂網域名稱將流量傳送至 API
<a name="rest-api-routing-mode"></a>

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

## 何時使用路由規則
<a name="when-to-use-routing-rules"></a>

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

建議您將流量導向 REST API 時，針對自訂網域名稱使用路由規則。您可以使用路由規則重新建立任何 API 映射。如需詳細資訊，請參閱[使用路由規則重新建立 API 映射](rest-api-routing-rules-recreate-api-mapping.md)。

對於 REST API，您也可以同時使用路由規則和 API 映射。若您同時使用路由規則和 API 映射，則 API Gateway 一律會先評估路由規則，再評估任何 API 映射。同時使用路由規則和 API 映射來移轉您目前的自訂網域名稱，或探索路由規則。

### 路由規則的考量事項
<a name="considerations-for-private-preview"></a>

下列考量事項可能會影響您使用路由規則：
+ 不支援使用 WebSocket 或 HTTP API 作為路由規則的目標 API。
+ 如果您的自訂網域名稱同時具有 REST 和 HTTP API 的 API 映射，則不支援路由規則。
+ 您可以建立私有自訂網域至私有 REST API 的路由規則。您可以建立公有自訂網域至區域或邊緣最佳化 API 的路由規則。
+ 您無法建立公有自訂網域至私有 API 的路由規則。您無法建立私有自訂網域名稱至公有 API 的路由規則。

## 選擇路由規則或是 API 映射
<a name="choose-between-routing-rules-and-api-mappings"></a>

建議您盡可能使用路由規則。只有在將流量傳送至 HTTP 或 WebSocket API 時才使用 API 映射。