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 (uuid)	目标仪表板 ID
positionConflictAction		positionConflictAction	可选。 用于指定作的参数，以防位置冲突。 如果存在冲突且未提供此参数，则将应用默认值 Tail。 如果没有冲突，则克隆的磁贴将具有与源中相同的位置。
targetModelId		string	可选。 用于指定目标模型 ID 的参数。 克隆链接到数据集的磁贴时，将目标模型 ID 传递给其他数据集以重新绑定新磁贴。
targetReportId		string (uuid)	可选。 用于指定目标报表 ID 的参数。 克隆链接到报表的磁贴时，将目标报表 ID 传递给其他报表，以将新磁贴重新绑定到其他报表。
targetWorkspaceId		string (uuid)	可选。 用于指定目标工作区 ID 的参数。 空 GUID （00000000-0000-0000-0000-000000000000） 指示 我的工作区。 如果未提供此参数，则会在与源磁贴相同的工作区中克隆磁贴。

响应

名称	类型	说明
200 OK	Tile	还行

定义

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

CloneTileRequest

Object

克隆磁贴的 Power BI 请求

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

positionConflictAction

枚举

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

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

Tile

Object

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	磁贴的显示名称