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 パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
dataset
|
path | True |
string (uuid) |
データセット ID |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
[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"
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Dataset |
データセットの Power BI ユーザー アクセス権エントリ |
|
Dataset |
ユーザーがデータセットに対して持っているアクセス権 (アクセス許可レベル) |
|
Dataset |
データセットにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー |
|
Principal |
プリンシパルの種類 |
|
Service |
Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。 |
DatasetUser
データセットの Power BI ユーザー アクセス権エントリ
| 名前 | 型 | 説明 |
|---|---|---|
| datasetUserAccessRight |
ユーザーがデータセットに対して持っているアクセス権 (アクセス許可レベル) |
|
| displayName |
string |
プリンシパルの表示名 |
| emailAddress |
string |
ユーザーのメール アドレス |
| graphId |
string |
Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。 |
| identifier |
string |
プリンシパルの識別子 |
| principalType |
プリンシパルの種類 |
|
| profile |
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 |
データセットにアクセスできるユーザーの一覧 |
PrincipalType
プリンシパルの種類
| 値 | 説明 |
|---|---|
| None |
プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。 |
| User |
ユーザー プリンシパルの種類 |
| Group |
グループ プリンシパルの種類 |
| App |
サービス プリンシパルの種類 |
ServicePrincipalProfile
Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。
| 名前 | 型 | 説明 |
|---|---|---|
| displayName |
string |
サービス プリンシパル プロファイル名 |
| id |
string (uuid) |
サービス プリンシパル プロファイル ID |