Datasets - Post Dataset User

指定したセマンティック モデルに対する、指定したユーザーのアクセス許可を付与します。 呼び出し元に必要なアクセス許可がある場合、セマンティック モデルは My ワークスペース または別のワークスペースに存在できます。

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

必要なスコープ

Dataset.ReadWrite.All

制限事項

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

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

URI パラメーター

要求本文

応答

例

Example

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

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

Example for granting ReadExplore right to a security group

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

定義

DatasetUserAccessRightEntry

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

PostDatasetUserAccess

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

PrincipalType

プリンシパルの種類