Workspaces - Provision Identity

サービス:

Core

API バージョン:

v1

ワークスペースのワークスペース ID をプロビジョニングします。
この API は、実行時間の長い操作 (LRO)をサポートします。

権限

呼び出し元には、ワークスペースに 管理者 ロールが必要です。

必要な委任されたスコープ

Workspace.ReadWrite.All

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

アイデンティティ	支援
ユーザー	イエス
サービス プリンシパルとマネージド ID	イエス

インターフェイス

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/provisionIdentity

URI パラメーター

名前	/	必須	型	説明
workspaceId	path	True	string (uuid)	ワークスペースの ID。

応答

名前	型	説明
200 OK	WorkspaceIdentity	正常にプロビジョニングされました
202 Accepted		承認された要求、ID プロビジョニングの進行中 ヘッダー Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラー コード: UnknownError - エラーが発生しました。

例

Provision workspace identity example

要求のサンプル

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/provisionIdentity

応答のサンプル

状態コード:

200

{
  "applicationId": "00a4a8f9-78d3-41b3-b87a-6ae5271c8d0d",
  "servicePrincipalId": "5ba4ae58-d402-45c6-a848-0253e834fd78"
}

状態コード:

202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 5

定義

名前	説明
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
WorkspaceIdentity	ワークスペース ID オブジェクト。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

WorkspaceIdentity

Object

ワークスペース ID オブジェクト。

名前	型	説明
applicationId	string	アプリケーション ID。
servicePrincipalId	string	サービス プリンシパル ID。