Admin - Dashboards GetTilesAsAdmin

服务:: Power BI REST APIs

API 版本:: v1.0

返回指定仪表板中的磁贴列表。

Permissions

用户必须是 Fabric 管理员或使用服务主体进行身份验证。
支持委派的权限。

在服务特权身份验证下运行时，应用不得在 Azure 门户中为 Power BI 设置任何管理员许可许可。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

仅在通过标准委派管理员访问令牌进行身份验证时相关。使用服务主体进行身份验证时不得存在。

局限性

每小时最多 200 个请求。

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

URI 参数

名称	在	必需	类型	说明
dashboardId	path	True	string (uuid)	仪表板 ID

响应

名称	类型	说明
200 OK	AdminTiles	好的

示例

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"
    }
  ]
}

定义

名称	说明
AdminTile	管理员 API 返回的 Power BI 磁贴。
AdminTiles	Power BI 磁贴集合的 OData 响应包装器

AdminTile

Object

管理员 API 返回的 Power BI 磁贴。

名称	类型	说明
colSpan	integer	平铺跨列数
datasetId	string	数据集 ID。仅适用于从报表创建的磁贴或使用数据集（如 Q&A 磁贴）。
embedData	string	磁贴的嵌入数据
embedUrl	string	磁贴的嵌入 URL
id	string (uuid)	磁贴 ID
reportId	string (uuid)	报表 ID。仅适用于从报表创建的磁贴。
rowSpan	integer	平铺跨行数
title	string	磁贴的显示名称

AdminTiles

Object

Power BI 磁贴集合的 OData 响应包装器

名称	类型	说明
@odata.context	string	OData 上下文
value	AdminTile[]	磁贴集合