Dashboards - Clone Tile In Group

服务:

Power BI REST APIs

API 版本:

v1.0

克隆指定工作区中的指定磁贴。

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

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

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

权限

此 API 调用可由服务主体配置文件调用。 有关详细信息，请参阅：Power BI Embedded中的服务主体配置文件。

必需范围

Dashboard.ReadWrite.All

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

URI 参数

名称	在	必需	类型	说明
dashboardId	path	True	string uuid	仪表板 ID
groupId	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	磁贴的显示名称