通过

Admin - Pipelines UpdateUserAsAdmin

  • 参考
Service:
Power BI REST APIs
API Version:
v1.0

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

权限

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

所需范围

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

Sample Request

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

Sample Response

Status code:
200

Add a service principal to a deployment pipeline example

Sample Request

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

Sample Response

Status code:
200

Add a user to a deployment pipeline example

Sample Request

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

Sample Response

Status code:
200

定义

名称 说明
PipelineUser

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

必需。 用户对部署管道的访问权限。
PrincipalType

主体类型

PipelineUser

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

名称 类型 说明
accessRight

PipelineUserAccessRight

必需。 用户对部署管道的访问权限。
identifier

string

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

PrincipalType

主体类型

PipelineUserAccessRight

必需。 用户对部署管道的访问权限。

名称 类型 说明
Admin

string

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

PrincipalType

主体类型

名称 类型 说明
App

string

服务主体类型
Group

string

组主体类型
None

string

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

string

用户主体类型