Admin - Apps GetAppUsersAsAdmin

服務:: 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/apps/{appId}/users

URI 參數

名稱	位於	必要	類型	Description
appId	path	True	string (uuid)	應用程式識別碼

回應

名稱	類型	Description
200 OK	AppUsers	還行

範例

Example

範例要求

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

定義

名稱	Description
AppUser	應用程式的 Power BI 使用者存取權專案
AppUserAccessRight	用戶對於應用程式的存取權
AppUsers	具有應用程式存取權之 Power BI 使用者清單的 OData 回應包裝函式
PrincipalType	主體類型

AppUser

Object

應用程式的 Power BI 使用者存取權專案

名稱	類型	Description
appUserAccessRight	AppUserAccessRight	用戶對於應用程式的存取權
displayName	string	主體的顯示名稱
emailAddress	string	用戶的電子郵件位址
graphId	string	Microsoft Graph 中主體的標識碼。僅適用於系統管理員 API。
identifier	string	主體的標識碼
principalType	PrincipalType	主體類型

AppUserAccessRight

列舉型別

用戶對於應用程式的存取權

值	Description
None	應用程式中的內容沒有許可權
Read	授與應用程式中內容的讀取許可權
ReadWrite	授與應用程式中內容的讀取和寫入存取權
ReadReshare	授與讀取和重新共用應用程式中內容的存取權
ReadWriteReshare	授與應用程式中內容的讀取、寫入和重新共用存取權
ReadExplore	授與讀取和探索應用程式中內容的存取權
ReadCopy	授與應用程式中內容的讀取和複製存取權
ReadExploreCopy	授與應用程式中內容的讀取、探索和複製存取權
ReadReshareExplore	授與讀取、重新共用和探索應用程式中內容的存取權
ReadReshareExploreCopy	授與讀取、重新共用、探索和複製應用程式中內容的存取權
ReadWriteExplore	授與應用程式中內容的讀取、寫入和探索存取權
ReadWriteReshareExplore	授與讀取、寫入、重新共用和探索應用程式中內容的存取權
ReadWriteExploreCopy	授與應用程式中內容的讀取、寫入、探索和複製存取權
ReadReshareCopy	授與應用程式中內容的讀取、重新共享和複製存取權
All	授與應用程式中內容的讀取、寫入、探索、重新共用和複製存取權

AppUsers