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

API Gateway 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 エンドポイントは、すべてのヘッダー名をそのまま渡します。

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

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

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