Datasets - Post Dataset User In Group
授予指定用户对指定数据集的权限。
最近更新用户对数据集的权限时，可能无法通过 API 调用立即获得新权限。 若要刷新用户权限，请使用 刷新用户权限 API 调用。
所需范围
Dataset.ReadWrite.All
局限性
- 不支持向服务主体（应用 principalType）添加权限
- 调用方必须对数据集具有 ReadReshare 权限。
- 此 API 调用不能用于授予数据集对数据集的写入权限
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/usersURI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
数据集 ID |
|
group
|
path | True |
string (uuid) |
工作区 ID |
请求正文
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| datasetUserAccessRight | True |
必填。 向用户授予数据集的访问权限。 |
|
| identifier | True |
string |
对于主体类型 |
| principalType | True |
主体类型 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
好的 |
示例
| Example |
|
Example for granting Read |
Example
示例请求
POST 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"
}示例响应
Example for granting ReadExplore right to a security group
示例请求
POST 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"
}示例响应
定义
| 名称 | 说明 |
|---|---|
|
Dataset |
必填。 向用户授予数据集的访问权限。 |
|
Post |
Power BI 用户访问数据集的权限条目 |
|
Principal |
主体类型 |
DatasetUserAccessRightEntry
必填。 向用户授予数据集的访问权限。
| 值 | 说明 |
|---|---|
| Read |
授予对数据集中内容的读取访问权限 |
| ReadReshare |
授予对数据集中内容的读取和重新共享访问权限 |
| ReadExplore |
授予对数据集中内容的读取和浏览访问权限 |
| ReadReshareExplore |
授予对数据集中内容的读取、重新共享和浏览访问权限 |
PostDatasetUserAccess
Power BI 用户访问数据集的权限条目
| 名称 | 类型 | 说明 |
|---|---|---|
| datasetUserAccessRight |
必填。 向用户授予数据集的访问权限。 |
|
| identifier |
string |
对于主体类型 |
| principalType |
主体类型 |
PrincipalType
主体类型
| 值 | 说明 |
|---|---|
| None |
无主体类型。 用于整个组织级别的访问。 |
| User |
用户主体类型 |
| Group |
组主体类型 |
| App |
服务主体类型 |