Datasets - Get Dataset Users

指定したセマンティック モデルにアクセスできるプリンシパルの一覧を返します。 呼び出し元に必要なアクセス許可がある場合、セマンティック モデルは My ワークスペース または別のワークスペースに存在できます。

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

Permissions

この API 呼び出しのアクセス許可は、 データセットのアクセス許可に一覧表示されます。

必要なスコープ

Dataset.Read.All または Dataset.ReadWrite.All

制限事項

呼び出し元には、データセットに対する ReadWriteReshare アクセス許可が必要です。 つまり、フォルダー管理者、再共有アクセス許可を持つメンバーと共同作成者、またはデータセット所有者です。

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

URI パラメーター

応答

例

Example

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

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

定義

DatasetUserAccess

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

DatasetUserAccessRight

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

DatasetUsersAccess

データセットにアクセスできる Power BI プリンシパルの一覧の OData 応答ラッパー

PrincipalType

プリンシパルの種類