共用方式為

Admin - Dashboards GetTilesAsAdmin

服務:
Power BI REST APIs
API 版本:
v1.0

傳回指定儀表板內的磚清單。

權限

  • 使用者必須是 Fabric 系統管理員，或使用服務主體進行驗證。
  • 支援委派權限。

在服務原則驗證下執行時，應用程式 不得 在 Azure 入口網站中設定任何系統管理員同意的 Power BI 豁免。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

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

局限性

每小時最多 200 個請求。 

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/tiles

URI 參數

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

string (uuid)

儀表板 ID

回應

名稱 類型 Description
200 OK

AdminTiles

OK

範例

Example

範例要求

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "title": "SalesMarketingTile",
      "embedUrl": "https://app.powerbi.com/embed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&tileId=312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "rowSpan": 0,
      "colSpan": 0,
      "reportId": "5b218778-e7a5-4d73-8187-f10824047715",
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

定義

名稱 Description
AdminTile

系統管理 API 傳回的 Power BI 磚。
AdminTiles

Power BI 磚集合的 OData 回應包裝函式

AdminTile

Object

系統管理 API 傳回的 Power BI 磚。

名稱 類型 Description
colSpan

integer

磚範圍欄的數目
datasetId

string

資料集 ID。 僅適用於從報表或使用資料集建立的磚，例如 Q&A 磚。
embedData

string

磚的內嵌資料
embedUrl

string

磚的內嵌 URL
id

string (uuid)

磚識別碼
reportId

string (uuid)

報表 ID。 僅適用於從報表建立的磚。
rowSpan

integer

磚範圍列數
title

string

磚的顯示名稱

AdminTiles

Object

Power BI 磚集合的 OData 回應包裝函式

名稱 類型 Description
@odata.context

string

OData 內容
value

AdminTile[]

磚集合