すべてのプロダクト
Search
ドキュメントセンター

API Gateway:専用インスタンスクラスター

最終更新日:Aug 26, 2026

API Gateway では、専用インスタンスをクラスター化し、それらの総合的なパフォーマンスを活用できます。

概要

個別の専用インスタンスでは、パフォーマンスに限界があります。最高スペックの専用インスタンスでもビジネス要件を満たせない場合は、複数の専用インスタンスをクラスター化してワークロードを分散できます。クラスター化できるのは、同じリージョン内の同じタイプおよび仕様のインスタンスのみです。クラスター化は DNS 名前解決によって行われます。専用インスタンスの仕様制限については、「専用インスタンス」をご参照ください。

image.png

専用インスタンスクラスターの基本操作

専用インスタンスクラスターの作成

  1. API Gateway コンソールにログインします。左側メニューで [専用インスタンスクラスター] を選択します。

  2. 表示されたページで、[クラスターの作成] をクリックします。[クラスターの作成] ダイアログボックスで、[名前] と [説明] パラメーターを指定し、[確認] をクリックします。

  3. 作成したクラスターのステータスは 準備完了 になります。

クラスターへのインスタンスの追加

  1. 作成したクラスターの [操作] 列にある [インスタンスの管理] をクリックします。

  2. 表示されたページで、[インスタンスの追加] をクリックし、追加するインスタンスを指定します。

    説明
    1. クラスターが準備完了の状態にある場合、追加できる専用インスタンスは 1 つのみです。クラスターは、このインスタンスの構成 (インスタンス仕様、バージョン、タイプを含む) をクラスター自体の構成として使用します。

    2. 最初に追加するインスタンスには API グループを含めることができます。インスタンスがクラスターに追加されると、API グループはクラスターに属します。

  3. [追加] をクリックします。システムがリソースを作成し、追加したインスタンスの構成を使用してクラスターを初期化します。クラスターが初期化されると、実行中 の状態になります。

  4. (オプション) クラスターにさらにインスタンスを追加します。一度に複数のインスタンスを追加できます。

    説明

    追加するインスタンスは、クラスターと同じ構成である必要があります。そうでない場合、以下のエラーが報告されることがあります:

    1. サーバーレスインスタンスはクラスターに追加できません。

    2. 追加しようとしているインスタンスのバージョンが異なります。この場合は、チケットを送信してインスタンスを更新してください。

    3. 追加しようとしているインスタンスの仕様が異なるため、追加できません。

    4. 追加しようとしているインスタンスのタイプが異なるため、追加できません。

    5. 追加しようとしているインスタンスには API グループが含まれているため、追加できません。

    6. 追加しようとしているインスタンスの インバウンド IPv6 トラフィック、アウトバウンド IPv6 トラフィック、または API Gateway からの呼び出し の構成が異なるため、追加できません。

    7. 追加しようとしているインスタンスの HTTPS セキュリティポリシー、専用インスタンスアクセス用 VPC、IPv6 アクセス制御、IPv4 アクセス制御、または カスタムプライベート CIDR ブロック の構成がクラスターと異なる場合、インスタンスは追加されますが、これらの構成は対応するクラスターの構成で上書きされます。

クラスター構成の変更

  1. 専用インスタンスクラスターリストで目的のクラスターを見つけて、[インスタンスの管理] ページに移動します。

  2. 表示されたページの右上にある [変更] をクリックして、クラスターの基本情報 (名前や説明など) を変更します。

  3. HTTPS セキュリティポリシー や 専用インスタンスアクセス用 VPC などの他の構成を変更します。変更は、クラスター内のすべての専用インスタンスに適用されます。

  4. クラスター内のすべての専用インスタンスが更新されると、クラスター構成の変更が完了します。

クラスターからのインスタンスの削除

  1. クラスターリストで目的のクラスターの [操作] 列にある [インスタンスの管理] をクリックします。

  2. 専用インスタンスリストで削除するインスタンスを選択し、右上の [インスタンスの削除] をクリックします。

    説明
    1. 削除処理中は、クラスター構成の変更、インスタンスの追加、他のインスタンスの削除を行うことができません。

    2. クラスターに API グループが含まれている場合、クラスターからすべての専用インスタンスを削除することはできません。

注意事項

  1. api.s2.large.x4 以上の仕様の専用インスタンスを追加できます。

  2. 1 つのクラスターに追加できる専用インスタンスは最大 20 個です。さらに多くのインスタンスを追加する場合は、チケットを送信してクォータの引き上げを申請してください。

  3. API グループを作成する際、API グループの所属先インスタンスとして専用インスタンスクラスターを指定できます。構成変更、インスタンスの追加、インスタンスの削除が進行中のクラスターでは、API グループを作成できません。

  4. 他の API Gateway インスタンスから専用インスタンスクラスターに API グループを移行できます。

  5. クラスターに専用インスタンスを追加した後、新しいエグレス IP アドレスも追加された場合は、接続の問題を防ぐために、バックエンドサービスのホワイトリストに新しいエグレス IP アドレスを追加する必要があります。

  6. 専用インスタンスを追加または削除すると、クラスター内の API グループのドメイン名に DNS 名前解決レコードが追加または削除されます。DNS 名前解決レコードの Time to Live (TTL) は 60 秒です。