Reports - Clone Report

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Clona il report specificato dall'area di lavoro personale.

Se il set di dati per un report clonato si trova in due aree di lavoro diverse o nell'area di lavoro personale, verrà creato un set di dati condiviso nell'area di lavoro del report.
Quando clonato, i report con una connessione dinamica perderanno tale connessione e invece avranno un'associazione diretta al set di dati di destinazione.

Autorizzazioni

L'utente deve avere tutti i requisiti seguenti, a meno che non si applichi un requisito:

Autorizzazione di scrittura per il report specificato.
Autorizzazione di compilazione per il set di dati di destinazione, obbligatoria se viene usato il targetModelId parametro .

Ambito obbligatorio

Content.Create

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Clone

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
reportId	path	True	string uuid	The report ID

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nuovo nome del report
targetModelId		string	facoltativo. Parametro per specificare l'ID set di dati associato alla destinazione. Se non specificato, il nuovo report verrà associato allo stesso set di dati del report di origine.
targetWorkspaceId		string	facoltativo. Parametro per specificare l'ID dell'area di lavoro di destinazione. Un GUID vuoto (`00000000-0000-0000-0000-000000000000`) indica l'area di lavoro personale. Se questo parametro non viene specificato, il nuovo report verrà clonato nella stessa area di lavoro del report di origine.

Risposte

Nome	Tipo	Descrizione
200 OK	Report	OK

Esempio

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone

Request Body

{
  "name": "New Report Name",
  "targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
  "targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}

Sample Response

Status code:: 200

Definizioni

Nome	Descrizione
CloneReportRequest	Richiesta di report clone di Power BI
PrincipalType	Tipo principale
Report	Report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
ReportUser	Voce a destra dell'accesso utente di Power BI per un report
ReportUserAccessRight	Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
Subscription	Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)
SubscriptionUser	Utente della sottoscrizione di posta elettronica di Power BI

CloneReportRequest

Richiesta di report clone di Power BI

Nome	Tipo	Descrizione
name	string	Nuovo nome del report
targetModelId	string	facoltativo. Parametro per specificare l'ID set di dati associato alla destinazione. Se non specificato, il nuovo report verrà associato allo stesso set di dati del report di origine.
targetWorkspaceId	string	facoltativo. Parametro per specificare l'ID dell'area di lavoro di destinazione. Un GUID vuoto (`00000000-0000-0000-0000-000000000000`) indica l'area di lavoro personale. Se questo parametro non viene specificato, il nuovo report verrà clonato nella stessa area di lavoro del report di origine.

PrincipalType

Tipo principale

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User	string	Tipo di entità utente

Report

Report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome	Tipo	Descrizione
appId	string	ID dell'app, restituito solo se il report appartiene a un'app
datasetId	string	ID set di dati del report
description	string	Descrizione del report
embedUrl	string	URL di incorporamento del report
id	string	The report ID
isOwnedByMe	boolean	Determinare se il report viene creato dall'utente corrente.
name	string	Nome del report
originalReportId	string	ID del report effettivo quando l'area di lavoro viene pubblicata come app.
reportType	enum: PaginatedReport PowerBIReport	Tipo di report
subscriptions	Subscription[]	(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando le sottoscrizioni get report come Amministrazione chiamata API.
users	ReportUser[]	(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente in un report di Power BI usando get report Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il `getArtifactUsers` parametro .
webUrl	string	URL Web del report

ReportUser

Voce a destra dell'accesso utente di Power BI per un report

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica dell'utente
graphId	string	Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier	string	Identificatore dell'entità
principalType	PrincipalType	Tipo principale
profile	ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
reportUserAccessRight	ReportUserAccessRight	Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
userType	string	Tipo dell'utente.

ReportUserAccessRight

Diritto di accesso che l'utente ha per il report (livello di autorizzazione)

Nome	Tipo	Descrizione
None	string	Nessuna autorizzazione per il contenuto nel report
Owner	string	Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel report
Read	string	Concede l'accesso in lettura al contenuto nel report
ReadCopy	string	Concede l'accesso in lettura e copia al contenuto nel report
ReadReshare	string	Concede l'accesso in lettura e ricondividi al contenuto nel report
ReadWrite	string	Concede l'accesso in lettura e scrittura al contenuto nel report

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome	Tipo	Descrizione
displayName	string	Nome del profilo dell'entità servizio
id	string	ID profilo dell'entità servizio

Subscription

Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)

Nome	Tipo	Descrizione
artifactDisplayName	string	Nome dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard.
artifactId	string	ID dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard.
artifactType	string	Tipo di elemento di Power BI (ad esempio , `ReportDashboard`o `Dataset`)
attachmentFormat	string	Formato del report collegato nella sottoscrizione di posta elettronica
endDate	string	Data e ora di fine della sottoscrizione di posta elettronica
frequency	string	Frequenza della sottoscrizione di posta elettronica
id	string	ID sottoscrizione
isEnabled	boolean	Se la sottoscrizione di posta elettronica è abilitata
linkToContent	boolean	Se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica
previewImage	boolean	Indica se esiste uno screenshot del report nella sottoscrizione di posta elettronica
startDate	string	Data e ora di inizio della sottoscrizione di posta elettronica
subArtifactDisplayName	string	Nome della pagina dell'elemento power BI sottoscritto, se si tratta di un report.
title	string	Nome dell'app
users	SubscriptionUser[]	Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa la chiamata Get User Subscriptions As Amministrazione API, il valore restituito è una matrice vuota (Null). Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report Subscriptions As Amministrazione o Get Dashboard Subscriptions As Amministrazione API call( Get Report Subscriptions As Amministrazione API call).

SubscriptionUser

Utente della sottoscrizione di posta elettronica di Power BI

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica dell'utente
graphId	string	Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier	string	Identificatore dell'entità
principalType	PrincipalType	Tipo principale
profile	ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
userType	string	Tipo dell'utente.

Condividi tramite