共用方式為

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 參數

名稱 位於 必要 類型 Description
pipelineId
 path True

string

uuid

部署管線識別碼

要求本文

名稱 必要 類型 Description
identifier True

string

針對主體類型 User ，請提供 UPN。 否則，請提供主體 的物件識別碼 。
principalType True

PrincipalType

主體類型
accessRight

PipelineUserAccessRight

必要。 使用者對於部署管線的存取權。

回應

名稱 類型 Description
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

定義

名稱 Description
PipelineUser

部署管線的 Power BI 使用者存取權專案
PipelineUserAccessRight

必要。 使用者對於部署管線的存取權。
PrincipalType

主體類型

PipelineUser

部署管線的 Power BI 使用者存取權專案

名稱 類型 Description
accessRight

PipelineUserAccessRight

必要。 使用者對於部署管線的存取權。
identifier

string

針對主體類型 User ，請提供 UPN。 否則，請提供主體 的物件識別碼 。
principalType

PrincipalType

主體類型

PipelineUserAccessRight

必要。 使用者對於部署管線的存取權。

名稱 類型 Description
Admin

string

將系統管理員許可權授與部署管線

PrincipalType

主體類型

名稱 類型 Description
App

string

服務主體類型
Group

string

群組主體類型
None

string

沒有主體類型。 用於整個組織層級存取。
User

string

使用者主體類型