Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

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

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

必要範圍

Dataset.ReadWrite.All

限制

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

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

URI 參數

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

要求本文

名稱	必要	類型	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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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
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	使用者主體類型