Admin - Dataflows GetDataflowDatasourcesAsAdmin

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

指定したデータフローのデータソースの一覧を返します。

削除されたデータソースは、応答に引き続き表示されます。これには、クラウドとオンプレミスの両方のデータゲートウェイソースが含まれる場合があります。詳細については、「データフローの考慮事項と制限事項」を参照してください。

アクセス許可

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

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

必要なスコープ

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

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

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/datasources

URI パラメーター

名前	/	必須	型	説明
dataflowId	path	True	string uuid	データフロー ID

応答

名前	型	説明
200 OK	Datasources	OK

例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/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[]	データソースコレクション

次の方法で共有