Dashboards - Clone Tile In Group

Service:

Power BI REST APIs

API Version:

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	OK

定義

名前	説明
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	タイルの表示名