共用方式為


Admin - Pipelines GetPipelineUsersAsAdmin

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

權限

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

必要範圍

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

{
  "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

使用者主體類型