Workspaces - Update Workspace Role Assignment

サービス:: Core

API バージョン:: v1

ワークスペースロールの割り当てを更新します。
最後の管理者のロールの割り当てを変更することはできません。

権限

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

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

Workspace.ReadWrite.All

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

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

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

インターフェイス

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments/{workspaceRoleAssignmentId}

URI パラメーター

名前	/	必須	型	説明
workspaceId	path	True	string (uuid)	ワークスペース ID。
workspaceRoleAssignmentId	path	True	string (uuid)	ワークスペースロールの割り当て ID。

要求本文

名前	必須	型	説明
role	True	WorkspaceRole	プリンシパルのワークスペースロール。

応答

名前	型	説明
200 OK	WorkspaceRoleAssignment	要求は正常に完了しました。
Other Status Codes	ErrorResponse	一般的なエラーコード: UnknownError - エラーが発生しました。

名前

型

説明

200 OK

WorkspaceRoleAssignment

要求は正常に完了しました。

Other Status Codes

ErrorResponse

一般的なエラーコード:

UnknownError - エラーが発生しました。

例

Update workspace role assignment example

要求のサンプル

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81

{
  "role": "Contributor"
}

応答のサンプル

状態コード:: 200

{
  "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
  "principal": {
    "displayName": "user1",
    "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "user1@microsoft.com"
    }
  },
  "role": "Contributor"
}

定義

名前	説明
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。
Principal	ID または Microsoft Entra グループを表します。
PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
UpdateWorkspaceRoleAssignmentRequest	ワークスペースロールの割り当て要求ペイロードを更新します。
UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。
WorkspaceRole	ワークスペースロール。追加のワークスペースロールは、時間の経過と同時に追加される場合があります。
WorkspaceRoleAssignment	ワークスペースロールの割り当てオブジェクト。

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	エラー関連のリソースの詳細。

GroupDetails

Object

グループ固有の詳細。プリンシパルの種類が Group場合に適用されます。

名前	型	説明
groupType	GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

GroupType

列挙

グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

値	説明
Unknown	プリンシパルグループの種類が不明です。
SecurityGroup	プリンシパルはセキュリティグループです。
DistributionList	プリンシパルは配布リストです。

Principal

Object

ID または Microsoft Entra グループを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
groupDetails	GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
id	string (uuid)	プリンシパルの ID。
servicePrincipalDetails	ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
type	PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
userDetails	UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

PrincipalType

列挙

プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

値	説明
User	プリンシパルは Microsoft Entra ユーザープリンシパルです。
ServicePrincipal	プリンシパルは Microsoft Entra サービスプリンシパルです。
Group	プリンシパルはセキュリティグループです。
ServicePrincipalProfile	プリンシパルはサービスプリンシパルプロファイルです。
EntireTenant	プリンシパルは、すべてのテナントユーザーを表します。

ServicePrincipalDetails

Object

サービスプリンシパル固有の詳細。プリンシパルの種類が ServicePrincipal場合に適用されます。

名前	型	説明
aadAppId	string (uuid)	サービスプリンシパルの Microsoft Entra AppId。

ServicePrincipalProfileDetails

Object

サービスプリンシパルプロファイルの詳細。プリンシパルの種類が ServicePrincipalProfile場合に適用されます。

名前	型	説明
parentPrincipal	Principal	サービスプリンシパルプロファイルの親プリンシパル。

UpdateWorkspaceRoleAssignmentRequest

Object

ワークスペースロールの割り当て要求ペイロードを更新します。

名前	型	説明
role	WorkspaceRole	プリンシパルのワークスペースロール。

UserDetails

Object

ユーザープリンシパル固有の詳細。プリンシパルの種類が User場合に適用されます。

名前	型	説明
userPrincipalName	string	ユーザープリンシパル名。

WorkspaceRole

列挙

ワークスペースロール。追加のワークスペースロールは、時間の経過と同時に追加される場合があります。

値	説明
Admin	ワークスペースへの管理アクセスを有効にします。
Member	ワークスペースへのメンバーシップアクセスを有効にします。
Contributor	ワークスペースへのコントリビューションを有効にします。
Viewer	ワークスペースの表示を有効にします。

WorkspaceRoleAssignment

Object

ワークスペースロールの割り当てオブジェクト。

名前	型	説明
id	string (uuid)	ワークスペースロールの割り当て ID。
principal	Principal	プリンシパル。
role	WorkspaceRole	プリンシパルのワークスペースロール。

次の方法で共有

Workspaces - Update Workspace Role Assignment

権限

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

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

インターフェイス

URI パラメーター

要求本文

応答

例

Update workspace role assignment example

要求のサンプル

応答のサンプル

定義

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UpdateWorkspaceRoleAssignmentRequest

UserDetails

WorkspaceRole

WorkspaceRoleAssignment