Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

授予指定用户对指定数据集的权限。

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

所需范围

Dataset.ReadWrite.All

限制

• 不支持向服务主体添加权限 (应用 principalType)
• 调用方必须具有对数据集的 ReadReshare 权限。
• 此 API 调用不能用于授予数据集的“写入”权限
  
  

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

URI 参数

名称	在	必需	类型	说明
datasetId	path	True	string	数据集 ID

请求正文

名称	必需	类型	说明
datasetUserAccessRight	True	DatasetUserAccessRightEntry	必需。 向用户授予数据集的访问权限。
identifier	True	string	对于主体类型 User，请提供 UPN。 否则，请提供主体 的对象 ID 。
principalType	True	PrincipalType	主体类型

响应

名称	类型	说明
200 OK		确定

示例

Example

Example for granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

定义

名称	说明
DatasetUserAccessRightEntry	必需。 向用户授予数据集的访问权限。
PostDatasetUserAccess	数据集的 Power BI 用户访问权限条目
PrincipalType	主体类型

DatasetUserAccessRightEntry

必需。 向用户授予数据集的访问权限。

名称	类型	说明
Read	string	授予对数据集中内容的读取访问权限
ReadExplore	string	授予对数据集中内容的读取和浏览访问权限
ReadReshare	string	授予对数据集中内容的读取和重新共享访问权限
ReadReshareExplore	string	授予对数据集中内容的读取、重新共享和浏览访问权限

PostDatasetUserAccess

数据集的 Power BI 用户访问权限条目

名称	类型	说明
datasetUserAccessRight	DatasetUserAccessRightEntry	必需。 向用户授予数据集的访问权限。
identifier	string	对于主体类型 User，请提供 UPN。 否则，请提供主体 的对象 ID 。
principalType	PrincipalType	主体类型

PrincipalType

主体类型

名称	类型	说明
App	string	服务主体类型
Group	string	组主体类型
None	string	无主体类型。 用于整个组织级别访问权限。
User	string	用户主体类型