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