Dashboards - Clone Tile In Group

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Clona o bloco especificado do workspace especificado.

Quando um bloco é clonado para outro workspace e associado a outro relatório e conjunto de dados, ele é clonado como está com sua consulta subjacente que contém os filtros de relatório originais.

Se a ID do relatório de destino e o conjunto de dados de destino estiverem ausentes, o seguinte poderá ocorrer:

Se você estiver clonando um bloco no mesmo workspace, os links de relatório e conjunto de dados serão clonados do bloco de origem.
Se você estiver clonando um bloco em um workspace diferente, os links de relatório e conjunto de dados serão removidos e o bloco será interrompido.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

Dashboard.ReadWrite.All

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
dashboardId	path	True	string uuid	A ID do dashboard
groupId	path	True	string uuid	A ID do workspace
tileId	path	True	string uuid	A ID do bloco

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
targetDashboardId	True	string	A ID de dashboard de destino
positionConflictAction		positionConflictAction	Opcional. Um parâmetro para especificar uma ação em caso de conflito de posição. Se houver um conflito e esse parâmetro não for fornecido, o valor `Tail` padrão será aplicado. Se não houver conflito, o bloco clonado terá a mesma posição que na origem.
targetModelId		string	Opcional. Um parâmetro para especificar uma ID de modelo de destino. Ao clonar um bloco vinculado a um conjunto de dados, passe a ID do modelo de destino para reassociar o novo bloco a um conjunto de dados diferente.
targetReportId		string	Opcional. Um parâmetro para especificar uma ID de relatório de destino. Ao clonar um bloco vinculado a um relatório, passe a ID do relatório de destino para reassociar o novo bloco a um relatório diferente.
targetWorkspaceId		string	Opcional. Um parâmetro para especificar uma ID de workspace de destino. Um GUID vazio (`00000000-0000-0000-0000-000000000000`) indica Meu workspace. Se esse parâmetro não for fornecido, o bloco será clonado no mesmo workspace que o bloco de origem.

Respostas

Nome	Tipo	Description
200 OK	Tile	OK

Definições

Nome	Description
CloneTileRequest	Uma solicitação do Power BI para clonar um bloco
positionConflictAction	Opcional. Um parâmetro para especificar uma ação em caso de conflito de posição. Se houver um conflito e esse parâmetro não for fornecido, o valor `Tail` padrão será aplicado. Se não houver conflito, o bloco clonado terá a mesma posição que na origem.
Tile	Um bloco do Power BI

CloneTileRequest

Uma solicitação do Power BI para clonar um bloco

Nome	Tipo	Description
positionConflictAction	positionConflictAction	Opcional. Um parâmetro para especificar uma ação em caso de conflito de posição. Se houver um conflito e esse parâmetro não for fornecido, o valor `Tail` padrão será aplicado. Se não houver conflito, o bloco clonado terá a mesma posição que na origem.
targetDashboardId	string	A ID de dashboard de destino
targetModelId	string	Opcional. Um parâmetro para especificar uma ID de modelo de destino. Ao clonar um bloco vinculado a um conjunto de dados, passe a ID do modelo de destino para reassociar o novo bloco a um conjunto de dados diferente.
targetReportId	string	Opcional. Um parâmetro para especificar uma ID de relatório de destino. Ao clonar um bloco vinculado a um relatório, passe a ID do relatório de destino para reassociar o novo bloco a um relatório diferente.
targetWorkspaceId	string	Opcional. Um parâmetro para especificar uma ID de workspace de destino. Um GUID vazio (`00000000-0000-0000-0000-000000000000`) indica Meu workspace. Se esse parâmetro não for fornecido, o bloco será clonado no mesmo workspace que o bloco de origem.

positionConflictAction

Opcional. Um parâmetro para especificar uma ação em caso de conflito de posição. Se houver um conflito e esse parâmetro não for fornecido, o valor Tail padrão será aplicado. Se não houver conflito, o bloco clonado terá a mesma posição que na origem.

Nome	Tipo	Description
Abort	string	Em caso de conflito de posição, a solicitação será cancelada.
Tail	string	No caso de conflito de posição, o bloco será adicionado no final do dashboard especificado.

Tile

Um bloco do Power BI

Nome	Tipo	Description
colSpan	integer	O número de colunas de intervalo de blocos
datasetId	string	A ID do conjunto de dados. Disponível somente para blocos criados a partir de um relatório ou usando um conjunto de dados, como blocos Q&A.
embedData	string	Os dados de inserção para o bloco
embedUrl	string	A URL de inserção do bloco
id	string	A ID do bloco
reportId	string	A ID do relatório. Disponível somente para blocos criados a partir de um relatório.
rowSpan	integer	O número de linhas de intervalo de blocos
title	string	O nome de exibição do bloco

Partilhar via