次の方法で共有

ワークスペースの重大な変更、パート 2 (2025 年 3 月)

  • [アーティクル]

適用対象: Premium

重要

これらの重大な変更は、Azure API Management のプレビュー ワークスペースにのみ適用されます。 2024 年 8 月の一般提供後にワークスペースを作成し、ワークスペース ゲートウェイでワークスペースを使用している場合、ワークスペースはこれらの変更の影響を受けません。

Azure API Management のワークスペースが一般提供され、そのリリースでいくつかの機能更新プログラムが導入されました。 ワークスペースの継続的な開発の一環として、プレビュー ワークスペース (2024 年 8 月より前に作成したもの) のサポートが削除されます。 Azure API Management でプレビュー ワークスペースを作成し、引き続き使用する場合は、ワークスペースを一般提供バージョンに移行する必要があります。

2025 年 3 月 31 日以降、最新のワークスペース機能に移行していない場合、プレビュー ワークスペースとそれらの中で管理されている API が動作しなくなる可能性があります。 ワークスペースの外部で管理されている API とリソースは、この変更の影響を受けません。

私が利用しているサービスはこの変更の影響を受けますか?

2024 年 8 月に一般提供されるワークスペースのリリースより前に API Management インスタンスでプレビュー ワークスペースを作成した場合、ご利用のサービスがこれらの変更の影響を受ける可能性があります。 API ランタイムにワークスペース ゲートウェイを使用する一般提供リリース日以降に作成されたワークスペースは、この重大な変更の影響を受けません。

重大な変更

プレビュー ワークスペースを一般提供バージョンに移行するためのアクションを実行する必要がある重大な変更を次に示します。

  • ワークスペース API ゲートウェイが必要です - 各ワークスペースは、ワークスペースのランタイム トラフィックを分離するワークスペース API ゲートウェイに関連付ける必要があります。 プレビューでは、ワークスペースはゲートウェイをサービスと共有していました。
  • サービス レベルのマネージド ID はサポートされていません - ワークスペースのセキュリティ向上のため、サービス レベルで有効になっているシステム割り当てマネージド ID とユーザー割り当てマネージド ID をワークスペースで使用することはできません。 現時点では、Azure Key Vault への名前付き値と証明書の格納、authentication-managed-identity ポリシーの使用など、マネージド ID に依存する関連する API Management 機能は、ワークスペースではサポートされていません。

Note

これらの重大な変更は、以前に発表されたプレビュー ワークスペースの 2024 年 7 月の重大な変更に加えて行われます。

変更の期日

重大な変更は、2025 年 3 月 31 日以降にプレビュー ワークスペースに適用されます。 プレビュー ワークスペースの構成に必要なすべての変更を、その日付より前に行うことを強くお勧めします。

何をする必要がありますか?

ワークスペースがこれらの変更の影響を受ける場合は、一般提供されている機能に合わせてワークスペースを移行する必要があります。 次のセクションでは、ワークスペースを移行する方法に関するガイダンスを提供します。

API Management インスタンスに Premium レベルを使用する

ワークスペースを引き続き使用するには、API Management インスタンスが Premium レベルで実行されていることを確認します。 以前お知らせしたように、インスタンスが Standard または Developer レベルにある場合は、Premium レベルにアップグレードする必要があります。

インスタンスのリージョンを確認する

ワークスペース ゲートウェイをワークスペースに追加するには、ゲートウェイがインスタンスと同じリージョンにある必要があります。 現在、ワークスペース ゲートウェイは、API Management を使用できるリージョンのサブセットでサポートされています。 ワークスペース ゲートウェイがサポートされているリージョンは、随時更新されます。

プレビュー ワークスペースがサポートされているリージョンにあるかどうかを確認するには:

  1. Azure portal で、API Management インスタンスに移動します。
  2. 左側のメニューの [API] で [ワークスペース] を選択し、ワークスペースを選択します。
  3. ワークスペースがワークスペース ゲートウェイをサポートしていないリージョンにある場合は、ポータルに "ワークスペースはご利用の API Management サービスのリージョンで現在使用できません" のようなメッセージが表示されます。
    • このメッセージが表示された場合は、サポートされているリージョンに API Management インスタンスを移動できます。
    • このメッセージが表示されない場合は、ワークスペースがサポートされているリージョンにあり、ワークスペース ゲートウェイの追加に進むことができます。

ワークスペース ゲートウェイをワークスペースに追加する

ワークスペース ゲートウェイをワークスペースに追加するための簡易手順を次に示します。 ゲートウェイのネットワーク オプション、前提条件、詳細な手順については、「ワークスペースの作成と管理」を参照してください。

Note

  • ワークスペース ゲートウェイには追加料金が発生します。 詳細については、「API Management の価格」を参照してください。
  • 1 つのワークスペース ゲートウェイに複数のワークスペースを関連付ける機能が導入されます。これにより、組織はワークスペースで API を、低コストで管理できるようになります。 この機能は 2024 年 12 月からロールアウトされており、1 月より前の時点では対象となるサービスのすべてで利用できるとは限りません。 詳細情報
  1. Azure portal で、API Management インスタンスに移動します。
  2. 左側のメニューの [API] で、[ワークスペース] を選択します。
  3. ワークスペースを選択します。
  4. 左側のメニューの [デプロイとインフラストラクチャ] で、[ゲートウェイ]> [+ 追加] を選択します。
  5. ウィザードを完了してゲートウェイを作成します。 現時点では、ゲートウェイのプロビジョニングには数分から最大 3 時間以上かかる場合があります。
  6. ゲートウェイがプロビジョニングされたら、ゲートウェイの [概要] ページに移動します。 [ランタイム ホスト名] の値をメモします。 この値を使用して、ワークスペースの API を呼び出すクライアント アプリを更新します。
  7. 残りのワークスペースに対して上記の手順を繰り返します。

新しいゲートウェイ ホスト名を使用するようにクライアント アプリを更新する

ワークスペースにゲートウェイを追加した後、API Management インスタンスのゲートウェイ ホスト名ではなく、新しいゲートウェイ ホスト名を使用するように、ワークスペースの API を呼び出すクライアント アプリを更新する必要があります。

Note

ワークスペースの移行を支援するために、2024 年 10 月までは、ワークスペース ゲートウェイがワークスペースに関連付けられている場合でも、API Management インスタンスのゲートウェイ ホスト名を使用して、ワークスペース内の API に実行時にアクセスできます。 この日付より前に移行を完了することを強くお勧めします。 ワークスペース ゲートウェイがプライベート受信アクセスとプライベート送信アクセスで構成されている場合は、API Management インスタンスの組み込みゲートウェイへの接続もセキュリティで保護されていることを確認してください。

サービス レベルのマネージド ID に対する依存関係を更新する

ワークスペース エンティティ (名前付き値や証明書など) の構成でサービス レベルのマネージド ID を使用している場合は、構成を更新する必要があります。 推奨される手順は、エンティティによって異なります。 例: Azure Key Vault に格納されているシークレットの代わりにシークレット値を使用するように名前付き値を更新します。

ヘルプとサポート

質問がある場合は、Microsoft Q&A でコミュニティの専門家から回答を得ることができます。 サポート プランに加入していて技術的な支援が必要な場合は、サポート リクエストを作成してください。

詳細

関連するコンテンツ

予定されているすべての破壊的変更と機能の廃止に関する記事を参照してください。