Datasets - Put Dataset User In Group

指定したユーザーの既存のデータセットのアクセス許可を、指定したアクセス許可に更新します。

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

必要なスコープ

Dataset.ReadWrite.All

アクセス許可

この API 呼び出しのアクセス許可は、 データセットのアクセス許可に記載されています。

制限事項

• サービス プリンシパル (アプリ プリンシパルタイプ) へのアクセス許可の更新はサポートされていません
• 呼び出し元には、データセットに対する ReadWriteReshare アクセス許可が必要です。 つまり、フォルダー管理者、再共有アクセス許可を持つメンバーと共同作成者、またはデータセットの所有者です。
• この API を使用して書 き込み アクセス許可を追加または削除することはできません。
• この API を使用して、フォルダー レベルの継承されたアクセス許可を削除することはできません。 フォルダー管理者とメンバーの場合、フォルダーのデータセットに対する ReadWriteReshareExplore アクセス許可が継承されます。 フォルダーの共同作成者の場合、フォルダーのデータセットに対する ReadWriteExplore アクセス許可が継承されます。 フォルダー ビューアーの場合、フォルダーのデータセットに対する読み取りアクセス許可が継承されます。
  
  

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

URI パラメーター

要求本文

応答

例

Example

PUT 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"
}

Example for updating security group dataset permissions to ReadExplore

PUT 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"
}

定義

DatasetUserAccess

データセットの Power BI プリンシパル アクセス権エントリ

DatasetUserAccessRight

ユーザーがデータセットに対して持つアクセス権 (アクセス許可レベル)

PrincipalType

プリンシパルの種類