次の方法で共有


Admin - Datasets GetDatasetUsersAsAdmin

指定したデータセットにアクセスできるユーザーの一覧を返します。

Permissions

  • ユーザーは、ファブリック管理者であるか、サービス プリンシパルを使用して認証されている必要があります。
  • 委任されたアクセス許可がサポートされています。
  • この API 呼び出しのアクセス許可は、 データセットのアクセス許可に一覧表示されます。

サービス 特権認証で実行する場合、アプリには、Azure portal で Power BI に対して管理者の同意が必要な使用許可が設定 されていない必要があります

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパル経由の認証を使用する場合は、存在しない必要があります。

制限事項

1 時間あたり最大 200 要求。

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

URI パラメーター

名前 / 必須 説明
datasetId
path True

string (uuid)

データセット ID

応答

名前 説明
200 OK

DatasetUsers

[OK]

Example

要求のサンプル

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

応答のサンプル

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "datasetUserAccessRight": "ReadWriteReshareExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

定義

名前 説明
DatasetUser

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

DatasetUserAccessRight

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

DatasetUsers

データセットにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー

PrincipalType

プリンシパルの種類

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。

DatasetUser

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

名前 説明
datasetUserAccessRight

DatasetUserAccessRight

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

displayName

string

プリンシパルの表示名

emailAddress

string

ユーザーのメール アドレス

graphId

string

Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。

identifier

string

プリンシパルの識別子

principalType

PrincipalType

プリンシパルの種類

profile

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。

userType

string

ユーザーの種類。

DatasetUserAccessRight

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

説明
None

データセット内のコンテンツへのアクセス許可を削除します

Read

データセット内のコンテンツへの読み取りアクセス権を付与します

ReadWrite

データセット内のコンテンツに対する読み取りと書き込みのアクセス権を付与します

ReadReshare

データセット内のコンテンツへの読み取りと再共有のアクセス権を付与します

ReadWriteReshare

データセット内のコンテンツへの読み取り、書き込み、および再共有アクセスを許可します

ReadExplore

データセット内のコンテンツへの読み取りと探索のアクセス権を付与します

ReadReshareExplore

データセット内のコンテンツへの読み取り、再共有、探索アクセスを許可します

ReadWriteExplore

データセット内のコンテンツへの読み取り、書き込み、探索のアクセス権を付与します

ReadWriteReshareExplore

データセット内のコンテンツへの読み取り、書き込み、再共有、探索アクセスを許可します

DatasetUsers

データセットにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー

名前 説明
@odata.context

string

value

DatasetUser[]

データセットにアクセスできるユーザーの一覧

PrincipalType

プリンシパルの種類

説明
None

プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。

User

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

Group

グループ プリンシパルの種類

App

サービス プリンシパルの種類

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。

名前 説明
displayName

string

サービス プリンシパル プロファイル名

id

string (uuid)

サービス プリンシパル プロファイル ID