Admin - Dashboards GetTilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

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

权限

• 用户必须具有管理员权限 (，例如Office 365全局管理员或 Power BI 服务管理员) 或使用服务主体进行身份验证。
• 支持委派权限。

在服务原始身份验证下运行时，应用不得在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

Sample Request

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

Sample Response

Status code:

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

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

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

AdminTiles

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

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