Admin - Capacities GetCapacityUsersAsAdmin

服務:

Power BI REST APIs

API 版本:

v1.0

傳回可存取指定工作區的用戶清單。

權限

• 用戶必須是網狀架構系統管理員。
• 支援委派的許可權。

在服務原始驗證下執行時，應用程式 不得 在 Azure 入口網站中設定 Power BI 的任何系統管理員同意必要先決條件。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

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

局限性

每小時最多 200 個要求。

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users

URI 參數

名稱	位於	必要	類型	Description
capacityId	path	True	string uuid	容量標識碼

回應

名稱	類型	Description
200 OK	CapacityUsers	還行

定義

名稱	Description
CapacityUser	容量的 Power BI 使用者存取權專案
capacityUserAccessRight	使用者對容量的存取權
CapacityUsers	可存取容量之 Power BI 使用者的 OData 回應包裝函式
PrincipalType	主體類型
ServicePrincipalProfile	Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。

CapacityUser

容量的 Power BI 使用者存取權專案

名稱	類型	Description
capacityUserAccessRight	capacityUserAccessRight	使用者對容量的存取權
displayName	string	主體的顯示名稱
emailAddress	string	用戶的電子郵件位址
graphId	string	Microsoft Graph 中主體的標識碼。 僅適用於系統管理員 API。
identifier	string	主體的標識碼
principalType	PrincipalType	主體類型
profile	ServicePrincipalProfile	Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。
userType	string	使用者的類型。

capacityUserAccessRight

使用者對容量的存取權

名稱	類型	Description
Admin	string	使用者具有容量的系統管理員許可權
Assign	string	使用者具有參與者許可權，並可將工作區指派給容量
None	string	用戶無法存取容量

CapacityUsers

可存取容量之 Power BI 使用者的 OData 回應包裝函式

名稱	類型	Description
odata.context	string
value	CapacityUser[]	具有容量存取權的用戶清單

PrincipalType

主體類型

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

ServicePrincipalProfile

Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。

名稱	類型	Description
displayName	string	服務主體配置檔名稱
id	string	服務主體配置檔識別碼