Datasets - Put Dataset User In Group

将指定用户的现有数据集权限更新为指定的权限。

最近更新用户对数据集的权限时，可能无法通过 API 调用立即获得新权限。若要刷新用户权限，请使用刷新用户权限 API 调用。此 API 调用可用于通过使用删除指定用户的所有数据集权限

所需范围

Dataset.ReadWrite.All

此 API 调用的权限列在数据集权限中。

不支持更新对服务主体（应用 principalType）的权限
调用方必须对数据集具有 ReadWriteReshare 权限。也就是说，具有重新共享权限或数据集所有者的文件夹管理员、成员和参与者。
此 API 不能用于添加或删除写入权限。
此 API 不能用于删除文件夹级继承的权限。对于文件夹管理员和成员，继承对文件夹数据集的 ReadWriteReshareExplore 权限。对于文件夹参与者，继承对文件夹数据集的 ReadWriteExplore 权限。对于文件夹查看器，继承对文件夹数据集的“读取”权限。

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

名称	在	必需	类型	说明
datasetId	path	True	string	数据集 ID
groupId	path	True	string (uuid)	工作区 ID

名称	必需	类型	说明
datasetUserAccessRight	True	DatasetUserAccessRight	要分配给数据集的用户的访问权限（权限级别）
identifier	True	string	对于主体类型 `User`，请提供 UPN。否则，请提供主体的对象 ID 。
principalType	True	PrincipalType	主体类型

名称	类型	说明
200 OK		好的

Example

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Object

数据集的 Power BI 主体访问权限条目

名称	类型	说明
datasetUserAccessRight	DatasetUserAccessRight	要分配给数据集的用户的访问权限（权限级别）
identifier	string	对于主体类型 `User`，请提供 UPN。否则，请提供主体的对象 ID 。
principalType	PrincipalType	主体类型

枚举

用户对数据集拥有的访问权限（权限级别）

值	说明
None	删除对数据集中内容的权限
Read	授予对数据集中内容的读取访问权限
ReadWrite	授予对数据集中内容的读取和写入访问权限
ReadReshare	授予对数据集中内容的读取和重新共享访问权限
ReadWriteReshare	授予对数据集中内容的读取、写入和重新共享访问权限
ReadExplore	授予对数据集中内容的读取和浏览访问权限
ReadReshareExplore	授予对数据集中内容的读取、重新共享和浏览访问权限
ReadWriteExplore	授予对数据集中内容的读取、写入和浏览访问权限
ReadWriteReshareExplore	授予对数据集中内容的读取、写入、重新共享和浏览访问权限

枚举

主体类型