共用方式為

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 參數

名稱 位於 必要 類型 Description
groupId
 path True

string

uuid

工作區標識碼

回應

名稱 類型 Description
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"
    }
  ]
}

定義

名稱 Description
Dataflow

數據流的元數據。 以下是可能針對數據流傳回的屬性清單。 根據呼叫的 API、呼叫端許可權和 Power BI 資料庫中數據的可用性，只會傳回屬性的子集。
Dataflows

數據流元數據清單的 OData 回應包裝函式
DataflowUser

數據流的Power BI使用者存取權專案
DataflowUserAccessRight

使用者對於資料流的存取權 （權限等級）
PrincipalType

主體類型
ServicePrincipalProfile

Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。

Dataflow

Object

數據流的元數據。 以下是可能針對數據流傳回的屬性清單。 根據呼叫的 API、呼叫端許可權和 Power BI 資料庫中數據的可用性，只會傳回屬性的子集。

名稱 類型 Description
configuredBy

string

數據流擁有者
description

string

數據流描述
modelUrl

string

資料串流定義檔的網址（model.json）
name

string

數據流名稱
objectId

string

數據流標識碼
users

DataflowUser[]

（空白值）數據流使用者存取詳細數據。 這個屬性將會從即將發行的承載回應中移除。 您可以使用 取得數據流使用者做為系統管理員 API 呼叫，或使用 getArtifactUser 參數 PostWorkspaceInfo API 呼叫來擷取 Power BI 數據流的用戶資訊。

Dataflows

Object

數據流元數據清單的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

value

Dataflow[]

數據流元數據清單

DataflowUser

Object

數據流的Power BI使用者存取權專案

名稱 類型 Description
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

使用者對於資料流的存取權 （權限等級）

值 Description
None

拿掉資料流中內容的許可權
Owner

授與數據流中內容的讀取、寫入和重新共用存取權
Read

授與數據流中內容的讀取許可權
ReadReshare

授與數據流中內容的讀取和重新共用存取權
ReadWrite

授與數據流中內容的讀取和寫入存取權

PrincipalType

Enumeration

主體類型

值 Description
App

服務主體類型
Group

群組主體類型
None

沒有主體類型。 用於整個組織層級存取。
User

用戶主體類型

ServicePrincipalProfile

Object

Power BI 服務主體配置檔。 僅與 Power BI Embedded 多租使用者解決方案相關。

名稱 類型 Description
displayName

string

服務主體配置檔名稱
id

string

服務主體配置檔識別碼