Admin - Datasets GetDatasourcesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

指定したデータセットのデータ ソースの一覧を返します。

各要求の処理には 0.5 秒かかり、その間に他の要求がキューに入れられます。

アクセス許可

• ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っているか、サービス プリンシパルを使用して認証する必要があります。
• 委任されたアクセス許可がサポートされています。

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

必要なスコープ

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

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

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

URI パラメーター

名前	/	必須	型	説明
datasetId	path	True	string

応答

名前	型	説明
200 OK	Datasources	OK

例

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "name": "301",
      "connectionString": "data source=MyServer.database.windows.net;initial catalog=MyDatabase;persist security info=True;encrypt=True;trustservercertificate=False",
      "datasourceType": "Sql",
      "datasourceId": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "server": "MyServer.database.windows.net",
        "database": "MyDatabase"
      }
    }
  ]
}

定義

名前	説明
Datasource	Power BI データ ソース
DatasourceConnectionDetails	Power BI データ ソース接続の詳細。 「 データソースを取得 する」または「 グループ内のデータソースを取得する」の例を参照してください。
Datasources	Power BI データ ソース コレクションの OData 応答ラッパー

Datasource

Power BI データ ソース

名前	型	説明
connectionDetails	DatasourceConnectionDetails	データ ソース接続の詳細
connectionString	string	(非推奨)データ ソース接続文字列。 DirectQuery でのみ使用できます。
datasourceId	string	バインドされたデータ ソース ID。ゲートウェイにバインドされていない場合は空です
datasourceType	string	データ ソースの種類
gatewayId	string	バインドされたゲートウェイ ID。ゲートウェイにバインドされていない場合は空です。 ゲートウェイ クラスターを使用する場合、ゲートウェイ ID はクラスター内のプライマリ (最初の) ゲートウェイを参照し、ゲートウェイ クラスター ID と似ています。
name	string	(非推奨)データ ソース名。 DirectQuery でのみ使用できます。

DatasourceConnectionDetails

Power BI データ ソース接続の詳細。 「 データソースを取得 する」または「 グループ内のデータソースを取得する」の例を参照してください。

名前	型	説明
account	string	接続アカウント
classInfo	string	接続クラス情報
database	string	接続データベース
domain	string	接続ドメイン
emailAddress	string	接続メール アドレス
kind	string	接続の種類
loginServer	string	接続ログイン サーバー
path	string	接続パス
server	string	接続サーバー
url	string	接続 URL

Datasources

Power BI データ ソース コレクションの OData 応答ラッパー

名前	型	説明
odata.context	string	OData コンテキスト
value	Datasource[]	データ ソースコレクション