# 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 API 设置边缘优化的自定义域名](how-to-edge-optimized-custom-domain-name.md)。

区域 API 端点按原样传递所有标头名称。

**注意**  
在 API 客户端在地理上分散的案例中，使用区域 API 端点以及您自己的 Amazon CloudFront 分配可能仍然有意义，这可确保 API Gateway 不会将 API 与服务控制的 CloudFront 分配关联。有关此使用案例的更多信息，请参阅[如何使用我自己的 CloudFront 分配设置 API Gateway？](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)* 是一个只能使用接口 VPC 端点从 Amazon Virtual Private Cloud (VPC) 访问的 API 端点，该接口是您在 VPC 中创建的端点网络接口 (ENI)。有关更多信息，请参阅 [API Gateway 中的私有 REST API](apigateway-private-apis.md)。

私有 API 端点按原样传递所有标头名称。