Pipelines - Get Pipeline Users

服務:

Power BI REST APIs

API 版本:

v1.0

傳回有權存取指定部署管線的使用者清單。

必要範圍

Pipeline.ReadWrite.All 或 Pipeline.Read.All

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

URI 參數

名稱	位於	必要	類型	Description
pipelineId	path	True	string (uuid)	部署管線識別碼

回應

名稱	類型	Description
200 OK	PipelineUsers	OK

範例

Get users of a deployment pipeline example

範例要求

GET https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

範例回覆

狀態碼:

200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

定義

名稱	Description
PipelineUser	部署管線的 Power BI 使用者存取權限專案
PipelineUserAccessRight	必須的。 使用者對部署管線的存取權限。
PipelineUsers	Power BI 部署管線使用者集合的 OData 回應包裝函式
PrincipalType	主體類型

PipelineUser

Object

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

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

PipelineUserAccessRight

列舉型別

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

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

PipelineUsers

Object

Power BI 部署管線使用者集合的 OData 回應包裝函式

名稱	類型	Description
@odata.context	string	OData 內容
value	PipelineUser[]	部署管線使用者的集合

PrincipalType

列舉型別

主體類型

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