Azure API Management のコンピューティング プラットフォーム

クラウドの PaaS (サービスとしてのプラットフォーム) である Azure API Management では、サービスのホストと実行に使用されるインフラストラクチャのさまざまな点が抽象化されています。 API Management インスタンスは、その基盤となるリソースについて知らなくても、ほとんどの要素を作成、管理、スケーリングすることができます。

Microsoft はサービスの機能を強化するため、いくつかのサービス レベルのインスタンスを対象に、API Management のコンピューティング プラットフォーム バージョン、つまりサービスのホストとなる Azure コンピューティング リソースをアップグレードしています。 この記事では、API Management のコンピューティング プラットフォームのメジャー バージョン (stv1 および stv2) とアップグレードの背景について取り上げます。

このアップグレードが API Management インスタンスの操作に及ぼす影響は最小限に抑えられています。 アップグレードはプラットフォームによって管理され、従量課金レベル以外のサービス レベルで作成された新しいインスタンスは、ほとんどが stv2 プラットフォームにホストされます。 ただし、stv1 プラットフォームにホストされている既存のインスタンスについては、stv2 プラットフォームへの移行をトリガーできます。

API Management のコンピューティング プラットフォームとは

次の表は、さまざまな API Management サービス レベルのインスタンスに現在使用されているコンピューティング プラットフォームをまとめたものです。

バージョン 説明 Architecture
stv2 Single-tenant v2 Azure によって割り当てられるコンピューティング インフラストラクチャ。可用性ゾーンやプライベート エンドポイントがサポートされます Developer、Basic、Standard、Premium1
stv1 Single-tenant v1 Azure によって割り当てられるコンピューティング インフラストラクチャ Developer、Basic、Standard、Premium
mtv1 Multi-tenant v1 共有インフラストラクチャ。ネイティブの自動スケーリングをサポートし、トラフィックのない時間はゼロにスケール ダウンされます 従量課金

1 これらのレベルで新しく作成されたインスタンス。Azure portal を使用して作成するか、API バージョン 2021-01-01-preview 以降を指定します。 仮想ネットワークまたは可用性ゾーンで構成された Developer レベルと Premium レベルの既存のインスタンスがいくつか含まれます。

注意

現在、stv2 プラットフォームは、米国政府クラウドまたは次の Azure リージョンでは使用できません:中国東部、中国東部 2、中国北部、中国北部 2。

API Management インスタンスのホストとなっているプラットフォームは、どのようにして確認できますか?

API バージョン 2021-04-01-preview 以降の API Management インスタンスは、このプラットフォーム情報を表示する読み取り専用の platformVersion プロパティを公開します。

この情報は、ポータルまたは API Management REST API を使用して確認できます。

ポータルで platformVersion プロパティを検索するには:

  1. API Management インスタンスに移動します。

  2. [概要] ページで、[JSON ビュー] を選択します。

  3. API バージョンで、現在のバージョン (2021-08-01 以降など) を選択します。

  4. JSON ビューで、下にスクロールして platformVersion プロパティを見つけます。

    JSON ビューの platformVersion プロパティ

stv2 プラットフォームに移行する方法

次の表は、stv1 プラットフォームに現在ホストされているさまざまな API Management サービス レベルのインスタンスの移行オプションをまとめたものです。 詳細な手順については、リンクされたドキュメントをご覧ください。

Note

移行を開始する前と、構成の変更後に platformVersionプロパティ を確認します。

レベル 移行オプション
Premium 1. ゾーン冗長性 を有効にする
または
2. 新しい 外部 または 内部 の VNet 接続1を作成する
または
3. 既存の VNet 構成 を更新する
開発者 1. 新しい 外部 または 内部 の VNet 接続1を作成する
または
2. 既存の VNet 構成 を更新する
Standard 1. サービス レベルを変更する (Developer にダウングレードするか、Premium にアップグレードする)。 新しいレベルの移行オプションに従います。
または
2. 既存のレベルで新しいインスタンスをデプロイし、構成を移行する2
Basic 1. サービス レベルを変更する (Developer にダウングレードするか、Premium にアップグレードする)。 新しいレベルの移行オプションに従います
または
2. 既存のレベルで新しいインスタンスをデプロイし、構成を移行する2
従量課金 適用できません

1 Azure portal を使用するか、API バージョン 2021-01-01-preview 以降を指定する。

2 次のメカニズムを使用して構成を移行する。バックアップと復元開発者ポータルの移行スクリプトAzure API Management を使用した APIOps

VNet 構成を更新する

仮想ネットワークに接続され、stv1 プラットフォームでホストされている既存の Developer レベル インスタンスまたは Premium レベル インスタンスがある場合は、VNet 構成を更新して stv2 プラットフォームへの移行をトリガーします。

前提条件

  • API Management インスタンスと同じリージョンおよびサブスクリプションにある新規または既存の仮想ネットワークとサブネット。 サブネットは、stv1 プラットフォームで ホストされているインスタンスに現在使用されているサブネットとは異なり、ネットワーク セキュリティ グループをアタッチする必要があります。

  • API Management インスタンスと同じリージョンおよびサブスクリプションにある新規または既存の Standard SKU パブリック IPv4 アドレス リソース。

ポータルを使用して既存の外部または内部の VNet 構成を更新するには:

  1. API Management インスタンスに移動します。
  2. 左側のメニューで、[ネットワーク]>[仮想ネットワーク] を選択します。
  3. 更新する場所でネットワーク接続を選択します。
  4. 構成する仮想ネットワーク、サブネット、および IP アドレス リソースを選択し、[適用] を選択します。
  5. API Management インスタンスの残りの場所に対して、VNet 設定の構成を続行します。
  6. 上部のナビゲーション バーで、 [保存] を選択してから、 [ネットワーク構成の適用] を選択します。

仮想ネットワーク構成が更新され、インスタンスが stv2 プラットフォームに移行されます。 プロパティplatformVersion を確認して移行を確認します。

Note

  • VNet 構成の更新が完了するまでに 15 分から 45 分かかります。
  • API Management インスタンスの VIP アドレスは変化します。

次のステップ