Datasets - Post Dataset User In Group

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

データセットに対するユーザーのアクセス許可が最近更新された場合、新しいアクセス許可が 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
{
  "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

定義

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

ユーザー プリンシパルの種類