Dashboards - Clone Tile

服務:

Power BI REST APIs

API 版本:

v1.0

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

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

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

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

必要範圍

Dashboard.ReadWrite.All

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

URI 參數

名稱	位於	必要	類型	Description
dashboardId	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	磚的顯示名稱