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

# API Gateway 中 REST API 的 API 端點類型
<a name="api-gateway-api-endpoint-types"></a>

*[API 端點](api-gateway-basic-concept.md#apigateway-definition-api-endpoints)* 類型是指 API 的主機名稱。根據您大部分 API 流量的來源而定，API 端點類型可以是*邊緣最佳化*、*區域*或*私有*。

## 邊緣最佳化的 API 端點
<a name="api-gateway-api-endpoint-types-edge-optimized"></a>

*[邊緣最佳化 API 端點](api-gateway-basic-concept.md#apigateway-definition-edge-optimized-api-endpoint)*通常會將請求路由至最靠近的 CloudFront 連接點 (POP)，該連接點可在您的用戶端分散各地的情況下提供協助。這是 API Gateway REST API 的預設端點類型。

邊緣最佳化 API 會提供 [HTTP 標頭](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)的名稱 (例如，`Cookie`)。

CloudFront 依據 Cookie 名稱以自然順序排序 HTTP Cookie，然後將請求轉送到原始伺服器。如需 CloudFront 處理 Cookie 方式的詳細資訊，請參閱[根據 Cookie 快取內容](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html)。

針對邊緣最佳化 API，您使用的任何自訂網域名稱適用於所有區域。

## 區域 API 端點
<a name="api-gateway-api-endpoint-types-regional"></a>

*[區域 API 端點](api-gateway-basic-concept.md#apigateway-definition-regional-api-endpoint)*適用於相同區域中的用戶端。當 EC2 執行個體上執行的用戶端呼叫相同區域中的 API 時，或當 API 是為了提供服務給具有高需求的少量用戶端時，區域 API 可降低連線成本。

針對區域 API，您使用的任何自訂網域名稱都是專屬於 API 部署所在的區域。如果您在多個區域中部署區域 API，其可在所有區域中擁有相同的自訂網域名稱。您可以使用自訂網域搭配 Amazon Route 53 來執行任務，例如[以延遲為基礎的路由](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency)。如需詳細資訊，請參閱[在 API Gateway 中設定區域性自訂網域名稱](apigateway-regional-api-custom-domain-create.md)及[設定 API Gateway 中的邊緣最佳化的自訂網域名稱](how-to-edge-optimized-custom-domain-name.md)。

所有區域和 API 端點會依原狀傳遞所有標頭名稱。

**注意**  
如果地理上 API 用戶端分散各處，則使用區域 API 端點與自己的 Amazon CloudFront 分佈搭配，以確保 API Gateway 不會將 API 與服務控制的 CloudFront 分佈建立關聯，這樣做可能仍有意義。如需此使用案例的詳細資訊，請參閱[如何設定 API Gateway 與自己的 CloudFront 分佈搭配？](https://repost.aws/knowledge-center/api-gateway-cloudfront-distribution)。

## 私有 API 端點
<a name="api-gateway-api-endpoint-types-private"></a>

*[私有 API 端點](api-gateway-basic-concept.md#apigateway-definition-private-api-endpoint)*是僅能從 Amazon Virtual Private Cloud (VPC) 透過界面 VPC 端點存取的 API 端點；此端點是您在 VPC 中建立的端點網路界面 (ENI)。如需更多詳細資訊，請參閱 [API Gateway 中的私有 REST API](apigateway-private-apis.md)。

所有私有 API 端點會依原狀傳遞所有標頭名稱。