Dashboards - Clone Tile

Service:

Power BI REST APIs

API Version:

v1.0

从 “我的工作区”克隆指定的磁贴。

将磁贴克隆到另一个工作区并绑定到另一个报表和数据集时，将按原样克隆该磁贴，其中包含原始报表筛选器的基础查询。

如果缺少目标报表 ID 和目标数据集，则可能发生以下情况：

• 如果要在同一工作区中克隆磁贴，将从源磁贴克隆报表和数据集链接。
• 如果要克隆其他工作区中的磁贴，将删除报表和数据集链接，并且该磁贴将断开。

所需范围

Dashboard.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/dashboards/{dashboardId}/tiles/{tileId}/Clone

URI 参数

名称	在	必需	类型	说明
dashboardId	path	True	string uuid	仪表板 ID
tileId	path	True	string uuid	磁贴 ID

请求正文

名称	必需	类型	说明
targetDashboardId	True	string	目标仪表板 ID
positionConflictAction		positionConflictAction	可选。 一个参数，用于在发生位置冲突时指定操作。 如果存在冲突且未提供此参数，则将应用默认值 Tail 。 如果没有冲突，则克隆的磁贴将具有与源中相同的位置。
targetModelId		string	可选。 用于指定目标模型 ID 的参数。 克隆链接到数据集的磁贴时，传递目标模型 ID 以将新磁贴重新绑定到其他数据集。
targetReportId		string	可选。 用于指定目标报表 ID 的参数。 克隆链接到报表的磁贴时，传递目标报表 ID 以将新磁贴重新绑定到其他报表。
targetWorkspaceId		string	可选。 用于指定目标工作区 ID 的参数。 空 GUID (00000000-0000-0000-0000-000000000000) 指示 “我的工作区”。 如果未提供此参数，则将在源磁贴所在的同一工作区中克隆该磁贴。

响应

名称	类型	说明
200 OK	Tile	确定

定义

名称	说明
CloneTileRequest	Power BI 请求克隆磁贴
positionConflictAction	可选。 一个参数，用于在发生位置冲突时指定操作。 如果存在冲突且未提供此参数，则将应用默认值 Tail 。 如果没有冲突，则克隆的磁贴将具有与源中相同的位置。
Tile	Power BI 磁贴

CloneTileRequest

Power BI 请求克隆磁贴

名称	类型	说明
positionConflictAction	positionConflictAction	可选。 一个参数，用于在发生位置冲突时指定操作。 如果存在冲突且未提供此参数，则将应用默认值 Tail 。 如果没有冲突，则克隆的磁贴将具有与源中相同的位置。
targetDashboardId	string	目标仪表板 ID
targetModelId	string	可选。 用于指定目标模型 ID 的参数。 克隆链接到数据集的磁贴时，传递目标模型 ID 以将新磁贴重新绑定到其他数据集。
targetReportId	string	可选。 用于指定目标报表 ID 的参数。 克隆链接到报表的磁贴时，传递目标报表 ID 以将新磁贴重新绑定到其他报表。
targetWorkspaceId	string	可选。 用于指定目标工作区 ID 的参数。 空 GUID (00000000-0000-0000-0000-000000000000) 指示 “我的工作区”。 如果未提供此参数，则将在源磁贴所在的同一工作区中克隆该磁贴。

positionConflictAction

可选。 一个参数，用于在发生位置冲突时指定操作。 如果存在冲突且未提供此参数，则将应用默认值 Tail 。 如果没有冲突，则克隆的磁贴将具有与源中相同的位置。

名称	类型	说明
Abort	string	如果位置冲突，请求将被取消。
Tail	string	如果位置冲突，磁贴将添加到指定仪表板的末尾。

Tile

Power BI 磁贴

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