Datasets - Put Dataset User In Group

将指定用户的现有数据集权限汇报指定权限。

最近更新用户对数据集的权限时,可能无法通过 API 调用立即获得新权限。 若要刷新用户权限,请使用 “刷新用户权限 API”调用。 This API call can be used to remove all the dataset permissions of the specified user by using datasetUserAccessRight: None

所需范围

Dataset.ReadWrite.All

权限

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

限制

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

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

URI 参数

名称 必需 类型 说明
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
Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

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"
}

Sample Response

Example for updating security group dataset permissions to ReadExplore

Sample Request

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"
}

Sample Response

定义

名称 说明
DatasetUserAccess

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

DatasetUserAccessRight

用户对数据集的访问权限 (权限级别)

PrincipalType

主体类型

DatasetUserAccess

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

名称 类型 说明
datasetUserAccessRight

DatasetUserAccessRight

要分配给数据集的用户的访问权限 (权限级别)

identifier

string

对于主体类型 User,请提供 UPN。 否则,请提供主体 的对象 ID

principalType

PrincipalType

主体类型

DatasetUserAccessRight

用户对数据集的访问权限 (权限级别)

名称 类型 说明
None

string

删除对数据集中内容的权限

Read

string

授予对数据集中内容的读取访问权限

ReadExplore

string

授予对数据集中内容的读取和浏览访问权限

ReadReshare

string

授予对数据集中内容的读取和重新共享访问权限

ReadReshareExplore

string

授予对数据集中内容的读取、重新共享和浏览访问权限

ReadWrite

string

授予对数据集中内容的读取和写入访问权限

ReadWriteExplore

string

授予对数据集中内容的读取、写入和浏览访问权限

ReadWriteReshare

string

授予对数据集中内容的读取、写入和重新共享访问权限

ReadWriteReshareExplore

string

授予对数据集中内容的读取、写入、重新共享和浏览访问权限

PrincipalType

主体类型

名称 类型 说明
App

string

服务主体类型

Group

string

组主体类型

None

string

无主体类型。 用于整个组织级别访问权限。

User

string

用户主体类型