Gateways - Get Datasource Users

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

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

アクセス許可

ユーザーにはゲートウェイ管理者のアクセス許可が必要です。

必要なスコープ

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

制限事項

仮想ネットワーク (VNet) ゲートウェイはサポートされていません。

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

URI パラメーター

名前	/	必須	型	説明
datasourceId	path	True	string uuid	データソース ID
gatewayId	path	True	string uuid	ゲートウェイ ID。ゲートウェイクラスターを使用する場合、ゲートウェイ ID はクラスター内のプライマリ (最初の) ゲートウェイを参照します。このような場合、ゲートウェイ ID はゲートウェイクラスター ID に似ています。

応答

名前	型	説明
200 OK	DatasourceUsers	OK

例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

定義

名前	説明
DatasourceUser	データソースにアクセスできる Power BI ユーザー
DatasourceUserAccessRight	ユーザーがデータソースに対して持っているアクセス権 (アクセス許可レベル)
DatasourceUsers	データソースにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー
PrincipalType	プリンシパルの種類
ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。マルチテナントソリューションPower BI Embeddedにのみ関連します。

DatasourceUser

データソースにアクセスできる Power BI ユーザー

名前	型	説明
datasourceAccessRight	DatasourceUserAccessRight	ユーザーがデータソースに対して持っているアクセス権 (アクセス許可レベル)
displayName	string	プリンシパルの表示名
emailAddress	string	ユーザーのメールアドレス
identifier	string	プリンシパルのオブジェクト ID
principalType	PrincipalType	プリンシパルの種類
profile	ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。マルチテナントソリューションPower BI Embeddedにのみ関連します。

DatasourceUserAccessRight

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

名前	型	説明
None	string	データソースにアクセスするためのアクセス許可がありません。ユーザーのアクセス許可を更新する場合にのみ適用されます。
Read	string	ユーザーが所有するデータセットは、データソースへの読み取りアクセス権を持っています
ReadOverrideEffectiveIdentity	string	ユーザーは、Power BI Embeddedの有効な ID をオーバーライドできます。オンプレミスの Analysis Services データソースにのみ適用されます。

DatasourceUsers

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

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

PrincipalType

プリンシパルの種類

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

ServicePrincipalProfile

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

名前	型	説明
displayName	string	サービスプリンシパルプロファイル名
id	string	サービスプリンシパルプロファイル ID

次の方法で共有