Datasets - Get Dataset Users

參考

Service:: Power BI REST APIs

API Version:: v1.0

傳回可存取指定資料集的主體清單。

最近更新資料集的使用者權限時，可能無法透過 API 呼叫立即取得新許可權。若要重新整理使用者權限，請使用重新整理使用者權限 API 呼叫。

權限

此 API 呼叫的許可權會列在資料集許可權中。

必要範圍

Dataset.Read.All 或 Dataset.ReadWrite.All

限制

呼叫端必須具有資料集的 ReadWriteReshare 許可權。也就是說，具有重新共用許可權或資料集擁有者的資料夾管理員、成員和參與者。

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

URI 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string	資料集識別碼

回應

名稱	類型	Description
200 OK	DatasetUsersAccess	確定

範例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

定義

名稱	Description
DatasetUserAccess	資料集的 Power BI 主體存取權專案
DatasetUserAccessRight	使用者對於資料集的存取權 (許可權等級)
DatasetUsersAccess	具有資料集存取權之 Power BI 主體清單的 OData 回應包裝函式
PrincipalType	主體類型

DatasetUserAccess

資料集的 Power BI 主體存取權專案

名稱	類型	Description
datasetUserAccessRight	DatasetUserAccessRight	要指派給資料集的使用者存取權限， (許可權等級)
identifier	string	針對主體類型 `User` ，請提供 UPN。否則，請提供主體的物件識別碼。
principalType	PrincipalType	主體類型

DatasetUserAccessRight

使用者對於資料集的存取權 (許可權等級)

名稱	類型	Description
None	string	移除資料集中內容的許可權
Read	string	授與資料集中內容的讀取權限
ReadExplore	string	授與資料集中內容的讀取和探索存取權
ReadReshare	string	授與資料集中內容的讀取和重新共用存取權
ReadReshareExplore	string	授與資料集中內容的讀取、重新共用和探索存取權
ReadWrite	string	授與資料集中內容的讀取和寫入存取權
ReadWriteExplore	string	授與資料集中內容的讀取、寫入和探索存取權
ReadWriteReshare	string	授與資料集中內容的讀取、寫入和重新共用存取權
ReadWriteReshareExplore	string	授與資料集中內容的讀取、寫入、重新共用和探索存取權

DatasetUsersAccess

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

名稱	類型	Description
odata.context	string
value	DatasetUserAccess[]	具有資料集存取權的使用者清單

PrincipalType

主體類型

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

共用方式為