Datasets - Put Dataset User

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

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

必要範圍

Dataset.ReadWrite.All

權限

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

限制

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

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

URI 參數

要求本文

回應

範例

Example

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

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

Example for updating security group dataset permissions to ReadExplore

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

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

定義

DatasetUserAccess

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

DatasetUserAccessRight

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

PrincipalType

主體類型