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

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

最終更新日:Jan 22, 2025

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セキュリティポリシー専用インスタンスへのアクセスのためのVPCIPv6アクセス制御IPv4アクセス制御、またはカスタムプライベートCIDRブロックの設定が異なり、追加後に対応するクラスター設定によって上書きされます。

クラスター設定の変更

  1. クラスターリストで管理するクラスターを見つけ、[操作] 列の [インスタンスの管理] をクリックします。

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

  3. HTTPSセキュリティポリシーVPC for Access to Dedicated Instanceなどの他の設定を変更します。 この変更は、クラスター内のすべての専用インスタンスに適用されます。

  4. すべての変更が期待どおりに適用されるまで待ちます。

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

  1. クラスターリストで管理するクラスターを見つけ、[操作] 列の [インスタンスの管理] をクリックします。

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

    説明
    1. 削除中は、クラスター設定の変更、インスタンスの追加、またはクラスターからの他のインスタンスの削除はできません。

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

使用上の注意

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

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

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

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

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

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