Reports - Update Report Content In Group

Service:

Power BI REST APIs

API Version:

v1.0

Updates den Inhalt des angegebenen Berichts aus dem angegebenen Arbeitsbereich mit dem Inhalt eines angegebenen Quellberichts.

Geben Sie den Quellbericht im Anforderungstext an.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Report.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/UpdateReportContent

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
groupId	path	True	string uuid	Arbeitsbereich-ID
reportId	path	True	string uuid	Die Berichts-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
sourceReport	True	SourceReport	Ein vorhandener Quellbericht
sourceType	True	sourceType	Der Quelltyp des Inhaltsupdates

Antworten

Name	Typ	Beschreibung
200 OK	Report	OK

Beispiele

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715/UpdateReportContent

Request Body

{
  "sourceReport": {
    "sourceReportId": "8e4d5880-81d6-4804-ab97-054665050799",
    "sourceWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
  },
  "sourceType": "ExistingReport"
}

Sample Response

Status code:

200

Definitionen

Name	Beschreibung
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 aufgerufenen API, 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 Mehrinstanzenlösung.
SourceReport	Ein vorhandener Quellbericht
sourceType	Der Quelltyp des Inhaltsupdates
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
UpdateReportContentRequest	Eine Power BI-Anforderung zum Aktualisieren des Berichtsinhalts

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf die gesamte 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 aufgerufenen API, 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	Die Berichtsbeschreibung
embedUrl	string	Die Einbettungs-URL des Berichts
id	string	Die Berichts-ID
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 einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den API-Aufruf Zum Abrufen von Berichtsabonnements als Admin verwenden.
users	ReportUser[]	(Leerer Wert) Die Benutzerzugriffsdetails für einen Power BI-Bericht. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen für einen Power BI-Bericht abrufen, indem Sie den Aufruf "Berichtsbenutzer als Admin API abrufen" oder den API-Aufruf PostWorkspaceInfo 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 Mehrinstanzenlösung.
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 erneuten Zugriff 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 Mehrinstanzenlösung.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID

SourceReport

Ein vorhandener Quellbericht

Name	Typ	Beschreibung
sourceReportId	string	Die ID des Quellberichts
sourceWorkspaceId	string	Die ID des Quellarbeitsbereichs

sourceType

Der Quelltyp des Inhaltsupdates

Name	Typ	Beschreibung
ExistingReport	string	Verwenden eines vorhandenen Berichts als Quelle des Inhalts, der zum Aktualisieren eines Zielberichts verwendet wird

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	Die 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 jedes E-Mail-Abonnenten. Wenn Sie den API-Aufruf Get User Subscriptions As Admin verwenden, ist der zurückgegebene Wert ein leeres Array (NULL). Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen zu einem Power BI-Bericht oder Dashboard abrufen, indem Sie die API-Aufrufe "Berichtsabonnements als Admin abrufen" oder "Dashboardabonnements als Admin abrufen" 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 Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

UpdateReportContentRequest

Eine Power BI-Anforderung zum Aktualisieren des Berichtsinhalts

Name	Typ	Beschreibung
sourceReport	SourceReport	Ein vorhandener Quellbericht
sourceType	sourceType	Der Quelltyp des Inhaltsupdates