Pipelines - Update Pipeline User

服務:

Power BI REST APIs

API 版本:

v1.0

授與指定部署管線的使用者權限。

必要範圍

Pipeline.ReadWrite.全部

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		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/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/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/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

要求本文

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

範例回覆

狀態碼:

200

定義

名稱	Description
PipelineUser	部署管線的 Power BI 使用者存取權限專案
PipelineUserAccessRight	必須的。 使用者對部署管線的存取權限。
PrincipalType	主體類型

PipelineUser

Object

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

名稱	類型	Description
accessRight	PipelineUserAccessRight	必須的。 使用者對部署管線的存取權限。
identifier	string	針對主體類型 User，提供 UPN。 否則，請提供主體的 物件識別碼 。
principalType	PrincipalType	主體類型

PipelineUserAccessRight

列舉型別

必須的。 使用者對部署管線的存取權限。

值	Description
Admin	授與部署管線的系統管理員權限

PrincipalType

列舉型別

主體類型

值	Description
None	沒有主體類型。 用於整個組織層級存取。
User	使用者主體類型
Group	群組主體類型
App	服務主體類型