共用方式為

Admin - Dashboards GetDashboardUsersAsAdmin

服務:
Power BI REST APIs
API 版本:
v1.0

傳回有權存取指定儀表板的使用者清單。

權限

  • 使用者必須是 Fabric 系統管理員，或使用服務主體進行驗證。
  • 支援委派權限。

在服務原則驗證下執行時，應用程式 不得 在 Azure 入口網站中設定任何系統管理員同意的 Power BI 豁免。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

只有在透過標準委派管理員存取權杖進行驗證時才相關。 使用透過服務主體進行驗證時，不得存在。

局限性

每小時最多 200 個請求。 

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

URI 參數

名稱 位於 必要 類型 Description
dashboardId
 path True

string (uuid)

儀表板 ID

回應

名稱 類型 Description
200 OK

DashboardUsers

OK

範例

Example

範例要求

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "dashboardUserAccessRight": "Owner",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

定義

名稱 Description
DashboardUser

儀錶板的 Power BI 使用者存取權限專案
DashboardUserAccessRight

使用者對儀表板的存取權限 （權限層級）
DashboardUsers

具有儀表板存取權的 Power BI 使用者清單的 OData 回應包裝函式
PrincipalType

主體類型
ServicePrincipalProfile

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。

DashboardUser

Object

儀錶板的 Power BI 使用者存取權限專案

名稱 類型 Description
dashboardUserAccessRight

DashboardUserAccessRight

使用者對儀表板的存取權限 （權限層級）
displayName

string

主體的顯示名稱
emailAddress

string

使用者的電子郵件地址
graphId

string

Microsoft Graph 中主體的識別碼。 僅適用於管理 API。
identifier

string

主體的識別碼
principalType

PrincipalType

主體類型
profile

ServicePrincipalProfile

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。
userType

string

使用者的類型。

DashboardUserAccessRight

列舉型別

使用者對儀表板的存取權限 （權限層級）

值 Description
None

儀表板中的內容沒有權限
Read

授與儀表板中內容的讀取存取權
ReadWrite

授與儀表板中內容的讀取和寫入存取權
ReadReshare

授與儀表板中內容的讀取和重新共用存取權
ReadCopy

授與儀表板中內容的讀取和複製存取權
Owner

授予對報告中內容的讀取、寫入和重新共享訪問權限

DashboardUsers

Object

具有儀表板存取權的 Power BI 使用者清單的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

value

DashboardUser[]

有權存取儀表板的使用者清單

PrincipalType

列舉型別

主體類型

值 Description
None

沒有主體類型。 用於整個組織層級存取。
User

使用者主體類型
Group

群組主體類型
App

服務主體類型

ServicePrincipalProfile

Object

Power BI 服務主體設定檔。 僅與 Power BI Embedded 多租用戶解決方案相關。

名稱 類型 Description
displayName

string

服務主體設定檔名稱
id

string (uuid)

服務主體設定檔識別碼