Dashboards - Clone Tile In Group

服務:

Power BI REST APIs

API 版本:

v1.0

從指定的工作區複製指定的圖格。

當圖格複製到另一個工作區並系結至另一個報表和數據集時，其會複製為包含原始報表篩選的基礎查詢。

如果遺漏目標報表標識符和目標數據集，可能會發生下列情況：

• 如果您要複製相同工作區內的圖格，則會從來源磚複製報表和數據集連結。
• 如果您要在不同的工作區內複製圖格，將會移除報表和數據集連結，且圖格將會中斷。

權限

此 API 呼叫可由服務主體配置檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded 中的服務主體配置檔。

必要範圍

Dashboard.ReadWrite.All

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

URI 參數

名稱	位於	必要	類型	Description
dashboardId	path	True	string uuid	儀錶板標識碼
groupId	path	True	string uuid	工作區識別碼
tileId	path	True	string uuid	圖格標識碼

要求本文

名稱	必要	類型	Description
targetDashboardId	True	string	目標儀錶板標識碼
positionConflictAction		positionConflictAction	選擇性。 在位置衝突時指定動作的參數。 如果發生衝突且未提供此參數，則會套用預設值 Tail 。 如果沒有衝突，則複製的圖格會與來源中的位置相同。
targetModelId		string	選擇性。 指定目標模型識別碼的參數。 複製連結至數據集的磚時，將目標模型標識符傳遞至不同的數據集，以將新的磚重新系結至不同的數據集。
targetReportId		string	選擇性。 指定目標報表標識子的參數。 複製連結至報表的磚時，將目標報表標識符傳遞至新磚以重新系結至不同的報表。
targetWorkspaceId		string	選擇性。 指定目標工作區識別碼的參數。 空的 GUID (00000000-0000-0000-0000-000000000000) 表示 [我的工作區]。 如果未提供此參數，則會在與來源磚相同的工作區內複製磚。

回應

名稱	類型	Description
200 OK	Tile	確定

定義

名稱	Description
CloneTileRequest	複製磚的Power BI要求
positionConflictAction	選擇性。 在位置衝突時指定動作的參數。 如果發生衝突且未提供此參數，則會套用預設值 Tail 。 如果沒有衝突，則複製的圖格會與來源中的位置相同。
Tile	Power BI 圖格

CloneTileRequest

Object

複製磚的Power BI要求

名稱	類型	Description
positionConflictAction	positionConflictAction	選擇性。 在位置衝突時指定動作的參數。 如果發生衝突且未提供此參數，則會套用預設值 Tail 。 如果沒有衝突，則複製的圖格會與來源中的位置相同。
targetDashboardId	string	目標儀錶板標識碼
targetModelId	string	選擇性。 指定目標模型識別碼的參數。 複製連結至數據集的磚時，將目標模型標識符傳遞至不同的數據集，以將新的磚重新系結至不同的數據集。
targetReportId	string	選擇性。 指定目標報表標識子的參數。 複製連結至報表的磚時，將目標報表標識符傳遞至新磚以重新系結至不同的報表。
targetWorkspaceId	string	選擇性。 指定目標工作區識別碼的參數。 空的 GUID (00000000-0000-0000-0000-000000000000) 表示 [我的工作區]。 如果未提供此參數，則會在與來源磚相同的工作區內複製磚。

positionConflictAction

Enumeration

選擇性。 在位置衝突時指定動作的參數。 如果發生衝突且未提供此參數，則會套用預設值 Tail 。 如果沒有衝突，則複製的圖格會與來源中的位置相同。

值	Description
Abort	發生位置衝突時，將會取消要求。
Tail	發生位置衝突時，圖格將會在指定的儀錶板結尾新增。

Tile

Object

Power BI 圖格

名稱	類型	Description
colSpan	integer	磚範圍數據行的數目
datasetId	string	數據集標識碼。 僅適用於從報表或使用數據集建立的磚，例如 Q&A 磚。
embedData	string	磚的內嵌數據
embedUrl	string	磚的內嵌 URL
id	string	圖格標識碼
reportId	string	報表標識碼。 僅適用於從報表建立的磚。
rowSpan	integer	磚範圍數據列的數目
title	string	圖格的顯示名稱