Freigeben über

Reports - Clone Report

  • Referenz
Service:
Power BI REST APIs
API Version:
v1.0

Klont den angegebenen Bericht aus "Mein Arbeitsbereich".

  • Wenn sich das Dataset für einen geklonten Bericht in zwei verschiedenen Arbeitsbereichen oder in "Mein Arbeitsbereich" befindet, wird ein freigegebenes Dataset im Arbeitsbereich des Berichts erstellt.
  • Beim Klonen verlieren Berichte mit einer Liveverbindung diese Verbindung und verfügen stattdessen über eine direkte Bindung an das Zieldataset.

Berechtigungen

Der Benutzer muss über alle folgenden Elemente verfügen, es sei denn, eine Anforderung trifft nicht zu:

  • Schreibberechtigung für den angegebenen Bericht.
  • Buildberechtigung für das Zieldataset, erforderlich, wenn der targetModelId Parameter verwendet wird.

Erforderlicher Bereich

Content.Create

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
reportId
 path True

string

uuid

Die Berichts-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
name True

string

Der neue Berichtsname
targetModelId

string

Optional. Parameter zum Angeben der Ziel-zugeordneten Dataset-ID. Falls nicht angegeben, wird der neue Bericht dem gleichen Dataset wie dem Quellbericht zugeordnet.
targetWorkspaceId

string

Optional. Parameter zum Angeben der Zielarbeitsbereichs-ID. Eine leere GUID (00000000-0000-0000-0000-000000000000) gibt Meinen Arbeitsbereich an. Wenn dieser Parameter nicht angegeben wird, wird der neue Bericht im selben Arbeitsbereich geklont wie der Quellbericht.

Antworten

Name Typ Beschreibung
200 OK

Report

OK

Beispiele

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

Definitionen

Name Beschreibung
CloneReportRequest

Anforderung eines Power BI-Klonberichts
PrincipalType

Der Prinzipaltyp
Report

ein Power BI-Bericht Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
ReportUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht
ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
Subscription

Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)
SubscriptionUser

Ein Power BI-E-Mail-Abonnementbenutzer

CloneReportRequest

Anforderung eines Power BI-Klonberichts

Name Typ Beschreibung
name

string

Der neue Berichtsname
targetModelId

string

Optional. Parameter zum Angeben der Ziel-zugeordneten Dataset-ID. Falls nicht angegeben, wird der neue Bericht dem gleichen Dataset wie dem Quellbericht zugeordnet.
targetWorkspaceId

string

Optional. Parameter zum Angeben der Zielarbeitsbereichs-ID. Eine leere GUID (00000000-0000-0000-0000-000000000000) gibt Meinen Arbeitsbereich an. Wenn dieser Parameter nicht angegeben wird, wird der neue Bericht im selben Arbeitsbereich geklont wie der Quellbericht.

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp
Group

string

Gruppenprinzipaltyp
None

string

Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf organization ganzen Organization ebene.
User

string

Benutzerprinzipaltyp

Report

ein Power BI-Bericht Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
appId

string

Die App-ID, die nur zurückgegeben wird, wenn der Bericht zu einer App gehört
datasetId

string

Die Dataset-ID des Berichts
description

string

Beschreibung des Berichts
embedUrl

string

Die Einbettungs-URL des Berichts
id

string

Die Berichts-ID
isOwnedByMe

boolean

Ermitteln Sie, ob der Bericht vom aktuellen Benutzer erstellt wird.
name

string

Der Name des Berichts
originalReportId

string

Die tatsächliche Berichts-ID, wenn der Arbeitsbereich als App veröffentlicht wird.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Der Berichtstyp
subscriptions

Subscription[]

(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard). Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie berichtsabonnements abrufen als Admin API-Aufruf verwenden.
users

ReportUser[]

(Leerer Wert) Die Benutzerzugriffsdetails für einen Power BI-Bericht. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen für einen Power BI-Bericht abrufen, indem Sie berichtsbenutzer als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem getArtifactUsers Parameter verwenden.
webUrl

string

Die Web-URL des Berichts

ReportUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals
emailAddress

string

E-Mail-Adresse des Benutzers
graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier

string

Bezeichner des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
reportUserAccessRight

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
userType

string

Typ des Benutzers.

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)

Name Typ Beschreibung
None

string

Keine Berechtigung für Inhalte im Bericht
Owner

string

Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte im Bericht
Read

string

Gewährt Lesezugriff auf Inhalte im Bericht
ReadCopy

string

Gewährt Lese- und Kopierzugriff auf Inhalte im Bericht
ReadReshare

string

Gewährt Lese- und Weiterfreigabezugriff auf Inhalte im Bericht
ReadWrite

string

Gewährt Lese- und Schreibzugriff auf Inhalte im Bericht

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string

Die Dienstprinzipalprofil-ID

Subscription

Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)

Name Typ Beschreibung
artifactDisplayName

string

Der Name des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)
artifactId

string

Die ID des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)
artifactType

string

Der Typ des Power BI-Elements (z. B. , ReportDashboardoder Dataset)
attachmentFormat

string

Format des Berichts, der im E-Mail-Abonnement angefügt ist
endDate

string

Enddatum und -uhrzeit des E-Mail-Abonnements
frequency

string

Häufigkeit des E-Mail-Abonnements
id

string

Die Abonnement-ID
isEnabled

boolean

Ob das E-Mail-Abonnement aktiviert ist
linkToContent

boolean

Ob ein Abonnementlink im E-Mail-Abonnement vorhanden ist
previewImage

boolean

Ob ein Screenshot des Berichts im E-Mail-Abonnement vorhanden ist
startDate

string

Startdatum und -uhrzeit des E-Mail-Abonnements
subArtifactDisplayName

string

Der Seitenname des abonnierten Power BI-Elements, wenn es sich um einen Bericht handelt.
title

string

Der App-Name
users

SubscriptionUser[]

Die Details der einzelnen E-Mail-Abonnenten. Wenn Sie den API-Aufruf "Benutzerabonnements abrufen als Admin" verwenden, ist der zurückgegebene Wert ein leeres Array (NULL). Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht oder Dashboard abrufen, indem Sie die API-Aufrufe Berichtsabonnements abrufen als Admin oder Dashboardabonnements abrufen als Admin verwenden.

SubscriptionUser

Ein Power BI-E-Mail-Abonnementbenutzer

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals
emailAddress

string

E-Mail-Adresse des Benutzers
graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier

string

Bezeichner des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType

string

Typ des Benutzers.