Datasets - Get Dataset Users

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

指定したデータセットにアクセスできるプリンシパルの一覧を返します。

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

アクセス許可

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

必要なスコープ

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

制限事項

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

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

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string	データセット ID

応答

名前	型	説明
200 OK	DatasetUsersAccess	OK

例

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "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	プリンシパルの種類

DatasetUserAccess

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

名前	型	説明
datasetUserAccessRight	DatasetUserAccessRight	データセットのユーザーに割り当てるアクセス権 (アクセス許可レベル)
identifier	string	プリンシパルの種類 `User`の場合は、 UPN を指定します。それ以外の場合は、プリンシパルのオブジェクト ID を指定します。
principalType	PrincipalType	プリンシパルの種類

DatasetUserAccessRight

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

名前	型	説明
None	string	データセット内のコンテンツへのアクセス許可を削除します
Read	string	データセット内のコンテンツへの読み取りアクセス権を付与します
ReadExplore	string	データセット内のコンテンツへの読み取りと探索のアクセス権を付与します
ReadReshare	string	データセット内のコンテンツへの読み取りと再共有のアクセス権を付与します
ReadReshareExplore	string	データセット内のコンテンツへの読み取り、再共有、探索のアクセス権を付与します
ReadWrite	string	データセット内のコンテンツに対する読み取りおよび書き込みアクセス権を付与します
ReadWriteExplore	string	データセット内のコンテンツへの読み取り、書き込み、探索のアクセス権を付与します
ReadWriteReshare	string	データセット内のコンテンツへの読み取り、書き込み、再共有のアクセス権を付与します
ReadWriteReshareExplore	string	データセット内のコンテンツへの読み取り、書き込み、再共有、および探索アクセスを許可します

DatasetUsersAccess

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

名前	型	説明
odata.context	string
value	DatasetUserAccess[]	データセットにアクセスできるユーザーの一覧

PrincipalType

プリンシパルの種類

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

次の方法で共有