Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

v1.0

授與使用者許可權給指定的部署管線。

必要範圍

Pipeline.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/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/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/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/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	使用者主體類型