次の方法で共有

Dataflows - Get Dataflows

  • リファレンス
サービス:
Power BI REST APIs
API バージョン:
v1.0

指定したワークスペースからのすべてのデータフローの一覧を返します。

権限

この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「Power BI Embedded でのサービス プリンシパル プロファイルの」を参照してください。

必要なスコープ

Dataflow.ReadWrite.All または Dataflow.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows

URI パラメーター

名前 / 必須 型 説明
groupId
 path True

string

uuid

ワークスペース ID

応答

名前 型 説明
200 OK

Dataflows

わかりました

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/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"
    }
  ]
}

定義

名前 説明
Dataflow

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

データフロー メタデータ リストの OData 応答ラッパー
DataflowUser

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

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

プリンシパルの種類
ServicePrincipalProfile

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

Dataflow

Object

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

名前 型 説明
configuredBy

string

データフローの所有者
description

string

データフローの説明
modelUrl

string

データフロー定義ファイルへの URL (model.json)
name

string

データフロー名
objectId

string

データフロー ID
users

DataflowUser[]

(空の値)データフロー ユーザー アクセスの詳細。 このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI データフローに関するユーザー情報を取得するには、Admin API 呼び出しとしてデータフロー ユーザーを取得するか、getArtifactUser パラメーターを使用して PostWorkspaceInfo API 呼び出しを使用します。

Dataflows

Object

データフロー メタデータ リストの OData 応答ラッパー

名前 型 説明
@odata.context

string

value

Dataflow[]

データフロー メタデータの一覧

DataflowUser

Object

データフローの 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

Enumeration

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

値 説明
None

データフロー内のコンテンツへのアクセス許可を削除します
Owner

データフロー内のコンテンツへの読み取り、書き込み、および再共有アクセスを許可します
Read

データフロー内のコンテンツへの読み取りアクセスを許可します
ReadReshare

データフロー内のコンテンツへの読み取りと再共有アクセスを許可します
ReadWrite

データフロー内のコンテンツへの読み取りと書き込みアクセスを許可します

PrincipalType

Enumeration

プリンシパルの種類

値 説明
App

サービス プリンシパルの種類
Group

グループ プリンシパルの種類
None

プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。
User

ユーザー プリンシパルの種類

ServicePrincipalProfile

Object

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

名前 型 説明
displayName

string

サービス プリンシパル プロファイル名
id

string

サービス プリンシパル プロファイル ID