# 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 (Point of Presence) にルーティングします。これは、クライアントが地理的に分散されている場合に役立ちます。これは、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 は、サービスが制御する CloudFront ディストリビューションに API を関連付けないようにします。このユースケースの詳細については、「[独自の 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)*は、Amazon Virtual Private Cloud (VPC) からしかアクセスできない API エンドポイントです。インターフェイス VPC エンドポイントは、VPC 内に作成するエンドポイントネットワークインターフェイス (ENI) です。詳細については、「[API Gateway のプライベート REST API](apigateway-private-apis.md)」を参照してください。

Private API エンドポイントは、すべてのヘッダー名をそのまま渡します。