Datasets - Get Dataset Users In Group

服务:: Power BI REST APIs

API 版本:: v1.0

返回有权访问指定数据集的主体列表。

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

权限

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

所需范围

Dataset.Read.All 或 Dataset.ReadWrite.All

局限性

调用方必须对数据集具有 ReadWriteReshare 权限。也就是说，具有重新共享权限或数据集所有者的文件夹管理员、成员和参与者。

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

URI 参数

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

响应

名称	类型	说明
200 OK	DatasetUsersAccess	还行

示例

Example

示例请求

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

示例响应

状态代码:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

定义

名称	说明
DatasetUserAccess	数据集的 Power BI 主体访问权限条目
DatasetUserAccessRight	用户对数据集拥有的访问权限（权限级别）
DatasetUsersAccess	有权访问数据集的 Power BI 主体列表的 OData 响应包装器
PrincipalType	主体类型

DatasetUserAccess

Object

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

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

DatasetUserAccessRight

枚举

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

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

DatasetUsersAccess

Object

有权访问数据集的 Power BI 主体列表的 OData 响应包装器

名称	类型	说明
@odata.context	string
value	DatasetUserAccess[]	有权访问数据集的用户列表

PrincipalType

枚举

主体类型

值	说明
None	无主体类型。用于整个组织级别的访问。
User	用户主体类型
Group	组主体类型
App	服务主体类型