共用方式為


Admin - Datasets GetDatasetUsersAsAdmin

傳回可存取指定資料集的使用者清單。

權限

  • 使用者必須具有系統管理員許可權 (,例如Office 365全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。
  • 支援委派的許可權。
  • 此 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

Sample Request

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

Sample Response

{
  "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

資料集的 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

string

移除資料集中內容的許可權

Read

string

授與資料集中內容的讀取權限

ReadExplore

string

授與資料集中內容的讀取和探索存取權

ReadReshare

string

授與資料集中內容的讀取和重新共用存取權

ReadReshareExplore

string

授與資料集中內容的讀取、重新共用和探索存取權

ReadWrite

string

授與資料集中內容的讀取和寫入存取權

ReadWriteExplore

string

授與資料集中內容的讀取、寫入和探索存取權

ReadWriteReshare

string

授與資料集中內容的讀取、寫入和重新共用存取權

ReadWriteReshareExplore

string

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

DatasetUsers

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

名稱 類型 Description
odata.context

string

value

DatasetUser[]

具有資料集存取權的使用者清單

PrincipalType

主體類型

名稱 類型 Description
App

string

服務主體類型

Group

string

群組主體類型

None

string

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

User

string

使用者主體類型

ServicePrincipalProfile

Power BI 服務主體設定檔。 僅適用于Power BI Embedded多租使用者解決方案

名稱 類型 Description
displayName

string

服務主體設定檔名稱

id

string

服務主體設定檔識別碼