Dataflows - Get Dataflows

參考

Service:: Power BI REST APIs

API Version:: 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

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows

Sample Response

Status code:: 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

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

名稱	類型	Description
configuredBy	string	資料流程擁有者
description	string	資料流程描述
modelUrl	string	資料流程定義檔案的 URL (model.json)
modifiedBy	string	修改資料流程的使用者
modifiedDateTime	string	上次修改資料流程的日期和時間
name	string	資料流程名稱
objectId	string	資料流程識別碼
users	DataflowUser[]	([空白] 值) 資料流程使用者存取詳細資料。這個屬性將會從即將發行的承載回應中移除。您可以使用取得資料流程使用者作為管理員API 呼叫，或使用參數的PostWorkspaceInfo API 呼叫 `getArtifactUser` ，來擷取 Power BI 資料流程的使用者資訊。

Dataflows

資料流程中繼資料清單的 OData 回應包裝函式

名稱	類型	Description
odata.context	string
value	Dataflow[]	資料流程中繼資料清單

DataflowUser

資料流程的 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

使用者對於資料流程的存取權， (許可權等級)

名稱	類型	Description
None	string	移除資料流程中內容的許可權
Owner	string	授與資料流程中內容的讀取、寫入和重新共用存取權
Read	string	授與資料流程中內容的讀取權限
ReadReshare	string	授與資料流程中內容的讀取和重新共用存取權
ReadWrite	string	授與資料流程中內容的讀取和寫入存取權

PrincipalType

主體類型

名稱	類型	Description
App	string	服務主體類型
Group	string	群組主體類型
None	string	沒有主體類型。用於整個組織層級存取。
User	string	使用者主體類型

ServicePrincipalProfile

Power BI 服務主體設定檔。僅適用于Power BI Embedded多租使用者解決方案。

名稱	類型	Description
displayName	string	服務主體設定檔名稱
id	string	服務主體設定檔識別碼

共用方式為