Amazon API Gateway
開発者ガイド

API Gateway API に対してセットアップするエンドポイントタイプを選択する

API エンドポイントタイプは、API のホスト名を参照します。API エンドポイントタイプは、API トラフィックの大部分の発信元となっている場所に応じて、エッジ最適化リージョン別、またはプライベートとすることができます。

エッジ最適化 API エンドポイント

エッジ最適化された API エンドポイントは、地理的に分散されたクライアントに最適です。API リクエストは、最寄りの CloudFront 接続ポイント (POP) にルーティングされます。これが API Gateway REST API 用のデフォルトのエンドポイントタイプです。

エッジ最適化された API では、HTTP ヘッダーの名前の最初の文字は大文字になります (例: Cookie)。

CloudFront は、リクエストをオリジンに転送する前に、Cookie 名の自然な順序で HTTP Cookie を並べ替えます。CloudFront が Cookie を処理する方法の詳細については、「Cookie に基づいたコンテンツのキャッシュ」を参照してください。

エッジ最適化された API に使用するカスタムドメイン名はすべてのリージョンに適用されます。

リージョン API エンドポイント

リージョン別 API エンドポイントは同じリージョンのクライアントを対象としています。EC2 インスタンスで実行されているクライアントが同じリージョンの API を呼び出す場合、または API が要求の高い少数のクライアントへのサービスを目的としている場合、リージョン別 API は接続のオーバーヘッドを減らします。詳細については、「API Gateway でリージョン API を設定する」を参照してください。

リージョン別 API の場合、ユーザーが使用するカスタムドメイン名は API がデプロイされているリージョンに固有です。複数のリージョンでリージョン別 API をデプロイする場合、すべてのリージョンで同じカスタムドメイン名を使用できます。カスタムドメインを Amazon Route 53 と組み合わせて使用すると、レイテンシーベースのルーティングなどのタスクを実行できます。詳細については、「API Gateway でリージョン別 API 用のカスタムドメイン名をセットアップする」および「エッジ最適化のカスタムドメイン名を作成する方法」を参照してください。

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

プライベート API エンドポイント

プライベート API エンドポイントは、Amazon Virtual Private Cloud (VPC) からしかアクセスできない API エンドポイントです。インターフェイス VPC エンドポイントは、VPC 内に作成するエンドポイントネットワークインターフェイス (ENI) です。詳細については、「Amazon API Gateway でプライベート API を作成する」を参照してください。

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