共用方式為

Admin - Datasets GetDatasetUsersAsAdmin

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

傳回可存取指定數據集的用戶清單。

權限

  • 用戶必須是網狀架構系統管理員，或使用服務主體進行驗證。
  • 支援委派的許可權。
  • 此 API 呼叫的許可權列在資料集許可權 中。

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

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

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

局限性

每小時最多 200 個要求。 

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

URI 參數

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

string (uuid)

數據集標識碼

回應

名稱 類型 Description
200 OK

DatasetUsers

還行

範例

Example

範例要求

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

範例回覆

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

定義

名稱 Description
DatasetUser

數據集的 Power BI 使用者存取權專案
DatasetUserAccessRight

使用者對於資料集的存取權（權限等級）
DatasetUsers

具有數據集存取權之 Power BI 使用者的 OData 回應包裝函式
PrincipalType

主體類型
ServicePrincipalProfile

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

DatasetUser

Object

數據集的 Power BI 使用者存取權專案

名稱 類型 Description
datasetUserAccessRight

DatasetUserAccessRight

使用者對於資料集的存取權（權限等級）
displayName

string

主體的顯示名稱
emailAddress

string

用戶的電子郵件位址
graphId

string

Microsoft Graph 中主體的標識碼。 僅適用於系統管理員 API。
identifier

string

主體的標識碼
principalType

PrincipalType

主體類型
profile

ServicePrincipalProfile

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

string

使用者的類型。

DatasetUserAccessRight

列舉型別

使用者對於資料集的存取權（權限等級）

值 Description
None

拿掉資料集中內容的許可權
Read

授與數據集中內容的讀取許可權
ReadWrite

授與數據集中內容的讀取和寫入存取權
ReadReshare

授與讀取和重新共享數據集中內容的存取權
ReadWriteReshare

授與數據集中內容的讀取、寫入和重新共用存取權
ReadExplore

授與讀取和探索數據集中內容的存取權
ReadReshareExplore

授與讀取、重新共用和探索數據集中內容的存取權
ReadWriteExplore

授與數據集中內容的讀取、寫入和探索存取權
ReadWriteReshareExplore

授與讀取、寫入、重新共用和探索數據集中內容的存取權

DatasetUsers

Object

具有數據集存取權之 Power BI 使用者的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

value

DatasetUser[]

具有數據集存取權的用戶清單

PrincipalType

列舉型別

主體類型

值 Description
None

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

用戶主體類型
Group

群組主體類型
App

服務主體類型

ServicePrincipalProfile

Object

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

名稱 類型 Description
displayName

string

服務主體配置檔名稱
id

string (uuid)

服務主體配置檔識別碼