Share via

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

  • [アーティクル]

適用対象: Developer | Standard | Premium

2024 年 6 月 14 日以降、Azure API Management でのワークスペース (プレビュー) の開発の一環として、いくつかの破壊的変更が導入されています。

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

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

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

重大な変更

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

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

次のサービス レベルでは、ワークスペース (Standard と Developer) はサポートされなくなりました。 ワークスペースは、プレミアム レベルで使用できます。

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

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

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

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

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

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

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

    Note

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

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

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

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

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

Note

ワークスペース レベルのポリシーでは、オブジェクト内のサービス レベルのユーザーを context 引き続き参照できます。

変更の期日

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

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

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

Standard レベルのお客様

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

開発者層のお客様

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

  • プレミアム 層インスタンス内の集計

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

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

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

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

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

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

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

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

割り当てがサポートされなくなりました 推奨される移行手順
ワークスペース API をサービス レベルの製品に割り当てる ワークスペース レベルの製品を使用する
ワークスペース API または製品をサービス レベルのタグに割り当てる ワークスペース レベルのタグを使用する

ヘルプとサポート

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

詳細

関連するコンテンツ

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