API Gateway での REST API の API エンドポイントタイプ
API エンドポイントタイプは、API のホスト名を参照します。API エンドポイントタイプは、API トラフィックの大部分の発信元となっている場所に応じて、エッジ最適化、リージョン別、またはプライベートとすることができます。
エッジ最適化 API エンドポイント
エッジ最適化 API エンドポイントは通常、リクエストを最寄りの CloudFront POP (Point of Presence) にルーティングします。これは、クライアントが地理的に分散されている場合に役立ちます。これは、API Gateway REST API のデフォルトのエンドポイントタイプです。
エッジ最適化された API では、HTTP ヘッダーCookie)。
CloudFront は、リクエストをオリジンに転送する前に、Cookie 名の自然な順序で HTTP Cookie を並べ替えます。CloudFront が Cookie を処理する方法の詳細については、「Cookie に基づいたコンテンツのキャッシュ」を参照してください。
エッジ最適化された API に使用するカスタムドメイン名はすべてのリージョンに適用されます。
リージョン API エンドポイント
リージョン API エンドポイントは、同じリージョン内のクライアントを対象としています。EC2 インスタンスで実行されているクライアントが同じリージョン内の API を呼び出すか、API が要求の高い少数のクライアントへのサービスを目的としている場合、リージョン API は接続のオーバーヘッドを減らします。
リージョン API の場合、ユーザーが使用するカスタムドメイン名は API がデプロイされているリージョンに固有です。複数のリージョンでリージョン別 API をデプロイする場合、すべてのリージョンで同じカスタムドメイン名を使用できます。カスタムドメインを Amazon Route 53 と組み合わせて使用すると、レイテンシーベースのルーティングなどのタスクを実行できます。詳細については、「API Gateway でリージョン別カスタムドメイン名を設定する」および「API Gateway でエッジ最適化カスタムドメイン名を設定する」を参照してください。
リージョン別 API エンドポイントは、すべてのヘッダー名をそのまま渡します。
注記
API クライアントが地理的に分散している場合にも、リージョン API エンドポイントを独自の Amazon CloudFront ディストリビューションと一緒に使用するのが合理的です。この場合、API Gateway は、サービスが制御する CloudFront ディストリビューションに API を関連付けないようにします。このユースケースの詳細については、「独自の CloudFront ディストリビューションで API Gateway をセットアップする方法を教えてください
プライベート API エンドポイント
プライベート API エンドポイントは、Amazon Virtual Private Cloud (VPC) からしかアクセスできない API エンドポイントです。インターフェイス VPC エンドポイントは、VPC 内に作成するエンドポイントネットワークインターフェイス (ENI) です。詳細については、「API Gateway のプライベート REST API」を参照してください。
Private API エンドポイントは、すべてのヘッダー名をそのまま渡します。
