Azure API Management サービスは、ゾーナル構成とゾーン冗長構成の両方で 可用性ゾーン をサポートします。
ゾーン - API Management ゲートウェイと API Management インスタンス (管理 API、開発者ポータル、Git 構成) のコントロール プレーンは、Azure リージョン内で選択した 1 つのゾーンにデプロイされます。
ゾーン冗長 - API Management インスタンス (管理 API、開発者ポータル、Git 構成) のゲートウェイとコントロール プレーンは、Azure リージョン内の 2 つ以上の物理的に分離されたゾーンにレプリケートされます。 ゾーン冗長性は、サービス インスタンスに回復性と高可用性を提供します。
この記事では、API Management インスタンスを可用性ゾーンに移行するための 3 つのシナリオについて説明します。 高可用性のために API Management を構成する方法の詳細については、 API Management の可用性と信頼性の確保に関するページを参照してください。
重要
API Management サービスのインフラストラクチャ (カスタム ドメインの構成、CA 証明書の追加、スケーリング、仮想ネットワーク構成、可用性ゾーンの変更、リージョンの追加など) の変更は、サービス レベルとデプロイのサイズによっては、完了するまでに 15 分以上かかることがあります。 スケール ユニットまたはマルチリージョン構成の数が多いインスタンスの場合、より長い時間が予想されます。 API Management へのローリング変更は、容量と可用性を維持するために慎重に実行されます。
サービスの更新中は、他のサービス インフラストラクチャの変更を行うことはできません。 ただし、API、製品、ポリシー、およびユーザー設定を構成できます。 サービスではゲートウェイのダウンタイムが発生 せず 、API Management は中断することなく API 要求に サービスを提供し続けます (開発者レベルを除く)。
前提条件
API Management の可用性ゾーンを構成するには、インスタンスが 可用性ゾーンをサポートする Azure リージョンのいずれかに存在する必要があります。
API Management インスタンスがない場合は、 Azure portal クイックスタートを使用して新しい Azure API Management インスタンスを作成する 方法に従って作成します。 Premium サービス レベルを選択します。
既存の API Management インスタンスがある場合は、それが Premium レベルにあることを確認します。 そうでない場合は、 Premium レベルにアップグレードします。
ダウンタイムの要件
移行オプションにゲートウェイのダウンタイム要件はありません。
考慮事項
外部または内部の仮想ネットワークにデプロイされている API Management インスタンスを Availability Zones に移行する場合は、オプションで新しいパブリック IP リソースを指定できます。 内部仮想ネットワークでは、パブリック IP は API 要求に対してではなく管理操作にのみ使用されます。 API Management の IP アドレスの詳細を確認します。
可用性ゾーンに移行したり、可用性ゾーンの構成を変更したりすると、パブリック IP アドレスとプライベート IP アドレスの変更がトリガーされます。
既定では、API Management によって可用性ゾーンが自動的に設定され、スケール ユニット が分散され、リージョンのゾーン可用性の変化に合わせて調整されます。 特定のゾーンを選択する場合は、スケール ユニットがゾーン間で均等に分散されていることを確認します。 たとえば、2 つの特定のゾーンを選択した場合、2 つのユニット、4 つのユニット、または 2 つのユニットの別の倍数を構成できます。
重要
特定のゾーンを選択すると、リソースはそれらのゾーンに固定されます。 選択したゾーン内のすべてのリソースが使用できなくなった場合、API Management インスタンスは使用できなくなります。
注
容量メトリックと独自のテストを使用して、ニーズに合わせてゲートウェイのパフォーマンスを提供するスケール ユニットの数を決定します。 ユニットを追加すると、追加のコストが発生します。 サービス インスタンスの スケーリングとアップグレード の詳細について説明します。
注
可用性ゾーンが API Management インスタンス用に構成されている場合、通常の動作条件下では、構成されているすべてのゾーンのすべてのスケール ユニットがアクティブになり、ゲートウェイ トラフィックを処理します。
プライマリの場所で API Management インスタンスの自動スケールを構成した場合は、可用性ゾーンを選択した後に自動スケール設定の調整が必要になる場合があります。 特定のゾーンを選択する場合、自動スケール ルールと制限内の API Management ユニットの数は、ゾーンの数の倍数である必要があります。
仮想ネットワークに挿入されていない既存のゲートウェイの場所
API Management インスタンスが仮想ネットワークに挿入されていない場合に、そのインスタンスの既存の場所を可用性ゾーンに移行するには:
Azure portal で API Management インスタンスに移動します。
[ デプロイ + インフラストラクチャ ] メニューで、[ 場所] を選択します。
[ 場所 ] ボックスで、移行する場所を選択します。 この場所では、前提条件で前述したように、可用性ゾーンをサポート する必要があります。
[ 単位 ] ボックスで、その場所に必要なスケール ユニット の数を選択します。
[ 可用性ゾーン ] ボックスで、[ 自動 ] 設定 (推奨) のままにするか、必要に応じて 1 つ以上のゾーンを選択します。 特定のゾーンを選択した場合、選択したユニット数は可用性ゾーン間で均等に分散する必要があります。 たとえば、3 つのユニットを選択した場合は、各ゾーンが 1 つのユニットをホストするように 3 つのゾーンを選択します。
[ 適用] を選択し、[ 保存] を選択します。
仮想ネットワークに挿入された既存のゲートウェイの場所
インスタンスが現在仮想ネットワークに挿入されているときに、API Management インスタンスの既存の場所を可用性ゾーンに移行するには:
Azure portal で API Management インスタンスに移動します。
[ デプロイ + インフラストラクチャ ] メニューで、[ 場所] を選択します。
[ 場所 ] ボックスで、移行する場所を選択します。 この場所では、前提条件で前述したように、可用性ゾーンをサポート する必要があります。
[ 単位 ] ボックスで、その場所に必要なスケール ユニット の数を選択します。
[ 可用性ゾーン ] ボックスで、[ 自動 ] 設定 (推奨) のままにするか、必要に応じて 1 つ以上のゾーンを選択します。 特定のゾーンを選択した場合、選択したユニット数は可用性ゾーン間で均等に分散する必要があります。 たとえば、3 つのユニットを選択した場合は、各ゾーンが 1 つのユニットをホストするように 3 つのゾーンを選択します。
[ パブリック IP アドレス] ボックスで、必要に応じて場所のパブリック IP アドレスを選択します。
[ 適用] を選択し、[ 保存] を選択します。
新しいゲートウェイの場所
API Management インスタンスに新しい場所を追加し、その場所の可用性ゾーンを有効にするには:
API Management インスタンスがプライマリの場所の仮想ネットワークにデプロイされている場合は、可用性ゾーンを有効にする予定の新しい場所に 、仮想ネットワーク、サブネット、およびオプションのパブリック IP アドレスを設定します。
Azure portal で API Management インスタンスに移動します。
[ デプロイ + インフラストラクチャ ] メニューで、[ 場所] を選択します。
[ + 追加] を選択して新しい場所を追加します。 この場所では、前提条件で前述したように、可用性ゾーンをサポート する必要があります。
[ 単位 ] ボックスで、その場所に必要なスケール ユニット の数を選択します。
[ 可用性ゾーン ] ボックスで、[ 自動 ] 設定 (推奨) のままにするか、必要に応じて 1 つ以上のゾーンを選択します。 特定のゾーンを選択した場合、選択したユニット数は可用性ゾーン間で均等に分散する必要があります。 たとえば、3 つのユニットを選択した場合は、各ゾーンが 1 つのユニットをホストするように 3 つのゾーンを選択します。
API Management インスタンスが仮想ネットワークにデプロイされている場合は、[ ネットワーク ] の下にあるボックスを使用して、その場所で使用可能な仮想ネットワーク、サブネット、およびオプションのパブリック IP アドレスを選択します。
[ 追加] を選択し、[ 保存] を選択します。
