ワークスペースを設定する

適用対象: Premium

ワークスペース (プレビュー) を設定して、分散型 API 開発チームが独自の API を管理および製品化できるようにします。一方、中央 API プラットフォーム チームは API Management インフラストラクチャを維持します。 ワークスペースを作成してアクセス許可を割り当てると、ワークスペース コラボレーターは独自の API、製品、サブスクリプション、および関連リソースを作成および管理することができます。

Note

  • ワークスペースは、API Management のプレビュー機能であり、特定の制限事項の対象となります。
  • ワークスペースは、API Management REST API バージョン 2022-09-01-preview 以降でサポートされます。
  • 価格に関する考慮事項については、「API Management の価格」を参照してください。

前提条件

  • API Management インスタンス。 必要に応じて、作成できます。

ワークスペースを作成する - ポータル

  1. Azure portal にサインインし、API Management インスタンスに移動します。

  2. 左側のメニューで、[ワークスペース (プレビュー)]>[追加] の順に選択します。 ポータルで API Management ワークスペースを作成しているスクリーンショット。

  3. [ワークスペースの作成] ウィンドウで、ワークスペースのわかりやすい名前、リソース ID、およびオプションの説明を入力します。 [保存] を選択します。

[ワークスペース] ページの一覧に新しいワークスペースが表示されます。 ワークスペースを選択して、その設定とリソースを管理します。

ワークスペースにユーザーを割り当てる - ポータル

ワークスペースを作成したら、ワークスペースのリソースを管理するためのアクセス許可をユーザーに割り当てます。 各ワークスペース ユーザーには、サービス スコープのワークスペース RBAC ロールとワークスペース スコープの RBAC ロールの両方を割り当てるか、カスタム ロールを使用して同等のアクセス許可を付与する必要があります。

Note

Microsoft Entra グループを設定すると、ワークスペースへのアクセス許可を複数のユーザーに割り当てることができ、管理を容易にすることができます。

サービス スコープのロールを割り当てる

  1. Azure portal にサインインし、API Management インスタンスに移動します。

  2. 左側のメニューで、[アクセス制御 (IAM)]>[追加] の順に選択します。

  3. ワークスペースの他のメンバーに次のいずれかのサービス スコープのロールを割り当てます。

    • API Management サービス ワークスペース API 開発者
    • API Management サービス ワークスペース API プロダクト マネージャー

ワークスペース スコープのロールを割り当てる

  1. API Management インスタンスのメニューで、[ワークスペース (プレビュー)]> 作成したワークスペースの名前の順に選択します。

  2. [ワークスペース] ウィンドウで、[アクセス制御 (IAM)]>[追加] の順に選択します。

  3. 次のいずれかのワークスペース スコープのロールをワークスペース メンバーに割り当てて、ワークスペース API やその他のリソースを管理します。

    • API Management ワークスペース閲覧者
    • API Management ワークスペース共同作成者
    • API Management ワークスペース API 開発者
    • API Management ワークスペース API プロダクト マネージャー

ワークスペースにリソースを移行する

オープンソースの Azure API Management ワークスペース移行ツールは、ワークスペース内のリソースの初期セットアップに役立ちます。 このツールを使用して、選択したサービスレベル API とその依存関係を Azure API Management インスタンスからワークスペースに移行します。

次のステップ