通过

Admin - Pipelines UpdateUserAsAdmin

服务:
Power BI REST APIs
API 版本:
v1.0

向用户授予对指定部署管道的权限。

Permissions

用户必须具有管理员权限。

所需范围

Tenant.ReadWrite.All

局限性

每小时最多 200 个请求。 

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

URI 参数

名称 在 必需 类型 说明
pipelineId
 path True

string (uuid)

部署管道 ID

请求正文

名称 必需 类型 说明
identifier True

string

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

PrincipalType

主体类型
accessRight

PipelineUserAccessRight

必填。 用户对部署管道具有的访问权限。

响应

名称 类型 说明
200 OK

好的

示例

Add a group to a deployment pipeline example
Add a service principal to a deployment pipeline example
Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

示例请求

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
请求正文
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

示例响应

状态代码:
200

Add a service principal to a deployment pipeline example

示例请求

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
请求正文
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

示例响应

状态代码:
200

Add a user to a deployment pipeline example

示例请求

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
请求正文
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

示例响应

状态代码:
200

定义

名称 说明
PipelineUser

部署管道的 Power BI 用户访问权限条目
PipelineUserAccessRight

必填。 用户对部署管道具有的访问权限。
PrincipalType

主体类型

PipelineUser

Object

部署管道的 Power BI 用户访问权限条目

名称 类型 说明
accessRight

PipelineUserAccessRight

必填。 用户对部署管道具有的访问权限。
identifier

string

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

PrincipalType

主体类型

PipelineUserAccessRight

枚举

必填。 用户对部署管道具有的访问权限。

值 说明
Admin

向部署管道授予管理员权限

PrincipalType

枚举

主体类型

值 说明
None

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

用户主体类型
Group

组主体类型
App

服务主体类型