ワークスペース - 破壊的変更 (2024 年 6 月)

適用対象: Developer | Standard | Premium

2024 年 6 月 14 日以降、Azure API Management での workspaces の開発の一環として、いくつかの破壊的変更が導入されています。

2024 年 6 月 14 日以降、ワークスペースとそれらの中で管理されている API は、変更するように設定された機能に引き続き依存している場合、動作を停止する可能性があります。 ワークスペースの外部で管理されている API とリソースは、この変更の影響を受けません。

サービスはこれらの変更の影響を受けますか?

API Management インスタンスでワークスペース (プレビュー) を構成した場合、サービスはこれらの変更の影響を受ける可能性があります。 この機能は、 Premium、 Standard、および Developer レベルで導入されました。

重大な変更

次の重大な変更を確認して、アクションを実行する必要があるかどうかを判断します。

サポートされているサービス レベルへの変更

次のサービス レベルでは、ワークスペース Standard と Developer がサポートされなくなります。 ワークスペースは、 Premium レベルで使用できます。

v2 レベルでの可用性については、 Azure API Management v2 レベルを参照してください。

ワークスペースでのサービス レベル エンティティの割り当てのサポートに対する変更

サービス レベルのエンティティに対するワークスペース エンティティの次の割り当てはサポートされなくなりました。

• ワークスペース API をサービス レベルの製品に割り当てる

• ワークスペース API をサービス レベルのタグに割り当てる

• ワークスペース製品をサービス レベルのタグに割り当てる

• 可視性制御のためにワークスペース製品にサービス レベル グループを割り当てる

  Note

  組み込みのゲスト グループと開発者グループは、引き続きワークスペースで使用できます。

サポートされているコンテキスト オブジェクトに対する変更

次の context オブジェクトは、ワークスペース ポリシーまたはサービス レベルの全 API ポリシーではサポートされなくなります。

• context.Api.Workspace
• context.Product.Workspace

代わりに、 context.Workspace オブジェクトを使用できます。

変更の期日

破壊的変更は、2024 年 6 月 14 日以降に導入される予定です。 その日付より前に、ワークスペースの構成に必要なすべての変更を行うことを強くお勧めします。

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

ワークスペースがこれらの変更の影響を受ける場合は、新しい機能に合わせてワークスペース構成を更新する必要があります。

Standard レベルのお客様

Standard レベルのワークスペースを使用している場合は、Premium レベルにアップグレードしてワークスペースの使用を続行します。

開発者層のお客様

開発者レベルは、シングル ユーザーまたはシングル チームのユース ケース向けに設計されています。 コンピューティング リソースの制限、SLA の不足、インフラストラクチャの冗長性がないため、ワークスペースとのマルチチームコラボレーションを容易にすることはできません。 Developer レベルでワークスペース プレビューを使用している場合は、次のいずれかのオプションを選択できます。

• Premium レベルのインスタンスでの集計

  各開発者層インスタンスを Premium レベルにアップグレードすることもできますが、1 つの Premium レベル インスタンスで複数の非運用環境を集約することを検討してください。 Premium レベルのワークスペースを使用して、さまざまな環境を分離します。

• 開発に開発者層インスタンスを使用し、運用環境で Premium レベルのワークスペースに移行する

  開発環境には開発者層インスタンスを使用できます。 より高い環境では、CI/CD パイプラインを使用するなど、各開発者層サービスの構成を Premium レベル のサービスのワークスペースに移行できます。 この方法では、複数の環境で構成を管理するときに、問題や競合が発生する可能性があります。

  現在開発者層インスタンスでワークスペースを使用している場合は、ワークスペースを使用せずに、ワークスペース構成を開発者層インスタンスに移行できます。

  1. API Management インスタンスから Resource Manager テンプレートをエクスポートします。 テンプレートは、 Azure ポータルから、または他のツールを使用して エクスポートできます。
  2. リソース ID 値の次の部分文字列を削除します。 /workspaces/[^/]+
  3. テンプレートをデプロイします。 詳細については、「 Quickstart: Azure portal を使用した ARM テンプレートの作成とデプロイ」を参照してください。

  ユース ケースによっては、API Management インスタンスで他の構成変更を実行する必要がある場合があります。

ワークスペース レベルのエンティティの割り当て

ワークスペース プレビューでワークスペース レベルのエンティティをサービス レベルのエンティティに割り当てた場合、移行ガイダンスについては次の表を参照してください。

ヘルプとサポート

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

詳細

• ワークスペースの概要
• ワークスペースの破壊的変更、パート 2 (2025 年 3 月)

関連するコンテンツ

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