Datasets - Put Dataset User In Group

Service:

Power BI REST APIs

API Version:

v1.0

更新指定使用者的現有資料集許可權至指定的許可權。

最近更新資料集的使用者權限時，可能無法透過 API 呼叫立即取得新許可權。 若要重新整理使用者權限，請使用 重新整理使用者權限 API 呼叫。 此 API 呼叫可用來移除指定使用者的所有資料集許可權，方法是使用 datasetUserAccessRight: None

必要範圍

Dataset.ReadWrite.All

權限

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

限制

• 不支援將許可權更新至服務主體 (應用程式 principalType)
• 呼叫端必須具有資料集的 ReadWriteReshare 許可權。 也就是說，具有重新共用許可權或資料集擁有者的資料夾管理員、成員和參與者。
• 此 API 無法用來新增或移除 寫入 許可權。
• 此 API 無法用來移除資料夾層級繼承的許可權。 對於資料夾管理員和成員，會繼承資料夾資料集的 ReadWriteReshareExplore 許可權。 對於資料夾參與者，會繼承資料夾資料集的 ReadWriteExplore 許可權。 對於資料夾檢視器，會繼承資料夾資料集的讀取權限。
  
  

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

URI 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string	資料集識別碼
groupId	path	True	string uuid	工作區識別碼

要求本文

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

回應

名稱	類型	Description
200 OK		確定

範例

Example

Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:

200

Example for updating security group dataset permissions to ReadExplore

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

定義

名稱	Description
DatasetUserAccess	資料集的 Power BI 主體存取權專案
DatasetUserAccessRight	使用者對於資料集的存取權 (許可權等級)
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	授與資料集中內容的讀取、寫入、重新共用和探索存取權

PrincipalType

主體類型

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