Admin - Dataflows GetDataflowsAsAdmin

リファレンス

サービス:: Power BI REST APIs

API バージョン:: v1.0

組織のデータフローの一覧を返します。

権限

ユーザーは、ファブリック管理者であるか、サービスプリンシパルを使用して認証されている必要があります。
委任されたアクセス許可がサポートされています。

サービス特権認証で実行する場合、アプリ は、Azure portal で Power BI に対して管理者の同意が必要な事前使用許可を設定 することはできません。

必要なスコープ

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

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

制限

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

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

省略可能なパラメーターを含む:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

URI パラメーター

名前	/	型	説明
$filter	query	string	Odata フィルタークエリパラメーター条件基づいて、結果のサブセットを返します。
$skip	query	integer int32	最初の n 件の結果をスキップします
$top	query	integer int32	最初の n 個の結果のみを返します

応答

名前	型	説明
200 OK	AdminDataflows	わかりました

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

応答のサンプル

状態コード:: 200

{
  "value": [
    {
      "objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
      "name": "AdventureWorks",
      "description": "Our Adventure Works",
      "modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

定義

名前	説明
AdminDataflow	管理 API によって返されるデータフローのメタデータ。データフローに対して返される可能性があるプロパティの一覧を次に示します。呼び出される API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に応じて、プロパティのサブセットのみが返されます。
AdminDataflows	Power BI 管理者データフローコレクションの OData 応答ラッパー
DataflowUser	データフローの Power BI ユーザーアクセス権エントリ
DataflowUserAccessRight	ユーザーがデータフローに対して持っているアクセス権 (アクセス許可レベル)
PrincipalType	プリンシパルの種類
ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。 Power BI Embedded マルチテナントソリューションにのみ関連します。

AdminDataflow

管理 API によって返されるデータフローのメタデータ。データフローに対して返される可能性があるプロパティの一覧を次に示します。呼び出される API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に応じて、プロパティのサブセットのみが返されます。

名前	型	説明
configuredBy	string	データフローの所有者
description	string	データフローの説明
modelUrl	string	データフロー定義ファイルへの URL (model.json)
modifiedBy	string	データフローを変更したユーザー
modifiedDateTime	string	データフローが最後に変更された日時
name	string	データフロー名
objectId	string	データフロー ID
users	DataflowUser[]	(空の値)データフローユーザーアクセスの詳細。このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI データフローに関するユーザー情報を取得するには、Admin API 呼び出しとしてデータフローユーザーを取得するか、`getArtifactUser` パラメーターを使用して PostWorkspaceInfo API 呼び出しを使用します。
workspaceId	string	データフローワークスペース ID。

AdminDataflows

Power BI 管理者データフローコレクションの OData 応答ラッパー

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

DataflowUser

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

名前	型	説明
DataflowUserAccessRight	DataflowUserAccessRight	ユーザーがデータフローに対して持っているアクセス権 (アクセス許可レベル)
displayName	string	プリンシパルの表示名
emailAddress	string	ユーザーのメールアドレス
graphId	string	Microsoft Graph のプリンシパルの識別子。管理者 API でのみ使用できます。
identifier	string	プリンシパルの識別子
principalType	PrincipalType	プリンシパルの種類
profile	ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。 Power BI Embedded マルチテナントソリューションにのみ関連します。
userType	string	ユーザーの種類。

DataflowUserAccessRight

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

名前	型	説明
None	string	データフロー内のコンテンツへのアクセス許可を削除します
Owner	string	データフロー内のコンテンツへの読み取り、書き込み、および再共有アクセスを許可します
Read	string	データフロー内のコンテンツへの読み取りアクセスを許可します
ReadReshare	string	データフロー内のコンテンツへの読み取りと再共有アクセスを許可します
ReadWrite	string	データフロー内のコンテンツへの読み取りと書き込みアクセスを許可します

PrincipalType

プリンシパルの種類

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

ServicePrincipalProfile

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

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

次の方法で共有