Admin - Dataflows GetDataflowsAsAdmin

參考

服務:: Power BI REST APIs

API 版本:: v1.0

傳回組織的數據流清單。

權限

用戶必須是網狀架構系統管理員，或使用服務主體進行驗證。
支援委派的許可權。

在服務原始驗證下執行時，應用程式不得在 Azure 入口網站中設定 Power BI 的任何系統管理員同意必要先決條件。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

只有在透過標準委派的系統管理員存取令牌進行驗證時才相關。使用透過服務主體進行驗證時，不得存在。

限制

每小時最多 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 參數

名稱	位於	類型	Description
$filter	query	string	根據 Odata 篩選查詢參數條件，傳回結果的子集。
$skip	query	integer int32	略過前 n 個結果
$top	query	integer int32	只傳回前 n 個結果

回應

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

定義

名稱	Description
AdminDataflow	系統管理員 API 所傳回之數據流的元數據。以下是可能針對數據流傳回的屬性清單。根據呼叫的 API、呼叫端許可權和 Power BI 資料庫中數據的可用性，只會傳回屬性的子集。
AdminDataflows	Power BI Admin 數據流集合的 OData 回應包裝函式
DataflowUser	數據流的Power BI使用者存取權專案
DataflowUserAccessRight	使用者對於資料流的存取權（權限等級）
PrincipalType	主體類型
ServicePrincipalProfile	Power BI 服務主體配置檔。僅與 Power BI Embedded 多租使用者解決方案相關。

AdminDataflow

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

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

AdminDataflows

Power BI Admin 數據流集合的 OData 回應包裝函式

名稱	類型	Description
odata.context	string	OData 內容
value	AdminDataflow[]	報表集合

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	服務主體配置檔識別碼

共用方式為