Admin - Apps GetAppUsersAsAdmin

參考

Service:: Power BI REST APIs

API Version:: v1.0

傳回可存取指定應用程式的使用者清單。

權限

使用者必須具有系統管理員許可權 (，例如Office 365全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。
支援委派的許可權。

在服務基本驗證下執行時，應用程式不得在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

Sample Request

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

Sample Response

Status code:: 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

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

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

AppUserAccessRight

使用者對於應用程式的存取權

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

AppUsers

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

名稱	類型	Description
odata.context	string
value	AppUser[]	可存取應用程式的使用者清單

PrincipalType

主體類型

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

共用方式為