共用方式為


Datasets - Post Dataset User In Group

將指定使用者的許可權授與指定的資料集。

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

必要範圍

Dataset.ReadWrite.All

限制

  • 不支援將許可權新增至服務主體 (應用程式 principalType)
  • 呼叫端必須具有資料集的 ReadReshare 許可權。
  • 此 API 呼叫無法用來授與資料集的寫入權限

POST 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

DatasetUserAccessRightEntry

必要。 授與使用者資料集的存取權限。

identifier True

string

針對主體類型 User ,請提供 UPN。 否則,請提供主體 的物件識別碼

principalType True

PrincipalType

主體類型

回應

名稱 類型 Description
200 OK

確定

範例

Example
Example for granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

定義

名稱 Description
DatasetUserAccessRightEntry

必要。 授與使用者資料集的存取權限。

PostDatasetUserAccess

資料集的 Power BI 使用者存取權專案

PrincipalType

主體類型

DatasetUserAccessRightEntry

必要。 授與使用者資料集的存取權限。

名稱 類型 Description
Read

string

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

ReadExplore

string

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

ReadReshare

string

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

ReadReshareExplore

string

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

PostDatasetUserAccess

資料集的 Power BI 使用者存取權專案

名稱 類型 Description
datasetUserAccessRight

DatasetUserAccessRightEntry

必要。 授與使用者資料集的存取權限。

identifier

string

針對主體類型 User ,請提供 UPN。 否則,請提供主體 的物件識別碼

principalType

PrincipalType

主體類型

PrincipalType

主體類型

名稱 類型 Description
App

string

服務主體類型

Group

string

群組主體類型

None

string

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

User

string

使用者主體類型