Admin - Pipelines GetPipelineUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

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

權限

使用者必須具有系統管理員許可權，或使用服務主體進行驗證。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

限制

每小時最多 200 個要求。

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

URI 參數

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

回應

名稱	類型	Description
200 OK	PipelineUsers	確定

範例

Get users of a deployment pipeline example

Sample Request

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

Sample Response

Status code:

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

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

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

PipelineUserAccessRight

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

名稱	類型	Description
Admin	string	授與系統管理員許可權給部署管線

PipelineUsers

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

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

PrincipalType

主體類型

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