Datasets - Post Dataset User In Group

Service:

Power BI REST APIs

API Version:

v1.0

指定したデータセットに対する指定したユーザーのアクセス許可を付与します。

データセットに対するユーザーのアクセス許可が最近更新された場合、新しいアクセス許可が API 呼び出しを通じてすぐに使用できなくなる可能性があります。 ユーザーのアクセス許可を更新するには、 Refresh User Permissions API 呼び出しを使用します。

必要なスコープ

Dataset.ReadWrite.All

制限事項

• サービス プリンシパル (アプリ プリンシパルタイプ) へのアクセス許可の追加はサポートされていません
• 呼び出し元には、データセットに対する ReadReshare アクセス許可が必要です。
• この API 呼び出しを使用して、データセットに対するデータセット書き込みアクセス許可を付与することはできません
  
  

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

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string	データセット ID
groupId	path	True	string uuid	ワークスペース ID

要求本文

名前	必須	型	説明
datasetUserAccessRight	True	DatasetUserAccessRightEntry	必須です。 データセットのユーザーに付与するアクセス権。
identifier	True	string	プリンシパルの種類 Userの場合は、 UPN を指定します。 それ以外の場合は、プリンシパルの オブジェクト ID を 指定します。
principalType	True	PrincipalType	プリンシパルの種類

応答

名前	型	説明
200 OK		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

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/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

定義

名前	説明
DatasetUserAccessRightEntry	必須です。 データセットのユーザーに付与するアクセス権。
PostDatasetUserAccess	データセットの Power BI ユーザー アクセス権エントリ
PrincipalType	プリンシパルの種類

DatasetUserAccessRightEntry

必須です。 データセットのユーザーに付与するアクセス権。

名前	型	説明
Read	string	データセット内のコンテンツへの読み取りアクセス権を付与します
ReadExplore	string	データセット内のコンテンツへの読み取りと探索のアクセス権を付与します
ReadReshare	string	データセット内のコンテンツへの読み取りと再共有のアクセス権を付与します
ReadReshareExplore	string	データセット内のコンテンツへの読み取り、再共有、探索のアクセス権を付与します

PostDatasetUserAccess

データセットの Power BI ユーザー アクセス権エントリ

名前	型	説明
datasetUserAccessRight	DatasetUserAccessRightEntry	必須です。 データセットのユーザーに付与するアクセス権。
identifier	string	プリンシパルの種類 Userの場合は、 UPN を指定します。 それ以外の場合は、プリンシパルの オブジェクト ID を 指定します。
principalType	PrincipalType	プリンシパルの種類

PrincipalType

プリンシパルの種類

名前	型	説明
App	string	サービス プリンシパルの種類
Group	string	グループ プリンシパルの種類
None	string	プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。
User	string	ユーザー プリンシパルの種類