Admin - Capacities GetCapacityUsersAsAdmin
傳回可存取指定工作區的用戶清單。
權限
- 用戶必須是網狀架構系統管理員。
- 支援委派的許可權。
在服務原始驗證下執行時，應用程式 不得 在 Azure 入口網站中設定 Power BI 的任何系統管理員同意必要先決條件。
必要範圍
Tenant.Read.All 或 Tenant.ReadWrite.All
只有在透過標準委派的系統管理員存取令牌進行驗證時才相關。 使用透過服務主體進行驗證時，不得存在。
局限性
每小時最多 200 個要求。
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/usersURI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
capacity
|
path | True |
string (uuid) |
容量標識碼 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
還行 |
定義
| 名稱 | Description |
|---|---|
|
Capacity |
容量的 Power BI 使用者存取權專案 |
|
capacity |
使用者對容量的存取權 |
|
Capacity |
可存取容量之 Power BI 使用者的 OData 回應包裝函式 |
|
Principal |
主體類型 |
|
Service |
Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。 |
CapacityUser
容量的 Power BI 使用者存取權專案
| 名稱 | 類型 | Description |
|---|---|---|
| capacityUserAccessRight |
使用者對容量的存取權 |
|
| displayName |
string |
主體的顯示名稱 |
| emailAddress |
string |
用戶的電子郵件位址 |
| graphId |
string |
Microsoft Graph 中主體的標識碼。 僅適用於系統管理員 API。 |
| identifier |
string |
主體的標識碼 |
| principalType |
主體類型 |
|
| profile |
Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。 |
|
| userType |
string |
使用者的類型。 |
capacityUserAccessRight
使用者對容量的存取權
| 值 | Description |
|---|---|
| None |
用戶無法存取容量 |
| Assign |
使用者具有參與者許可權，並可將工作區指派給容量 |
| Admin |
使用者具有容量的系統管理員許可權 |
CapacityUsers
可存取容量之 Power BI 使用者的 OData 回應包裝函式
| 名稱 | 類型 | Description |
|---|---|---|
| @odata.context |
string |
|
| value |
具有容量存取權的用戶清單 |
PrincipalType
主體類型
| 值 | Description |
|---|---|
| None |
沒有主體類型。 用於整個組織層級存取。 |
| User |
用戶主體類型 |
| Group |
群組主體類型 |
| App |
服務主體類型 |
ServicePrincipalProfile
Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。
| 名稱 | 類型 | Description |
|---|---|---|
| displayName |
string |
服務主體配置檔名稱 |
| id |
string (uuid) |
服務主體配置檔識別碼 |