Reports - Get Export To File Status In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt den aktuellen status des Auftrags "In Datei in Gruppe exportieren" für den angegebenen Bericht aus dem angegebenen Arbeitsbereich zurück.

Wenn der Exportauftrag status auf "Succeeded" festgelegt ist, verwenden Sie die GetFileOfExportToFile-API, um die Datei abzurufen.

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 oder Report.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/exports/{exportId}

URI-Parameter

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

Antworten

Name	Typ	Beschreibung
200 OK	Export	OK
202 Accepted	Export	Akzeptiert

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/exports/{exportId}

Sample Response

Status code:: 200

{
  "id": "Mi9C5419i....PS4=",
  "createdDateTime": "2021-12-08T10:26:09.3069086Z",
  "lastActionDateTime": "2021-12-08T10:26:38.016851Z",
  "reportId": "cad51cfa-e740-324f-acbb-8ca43c40a2d4",
  "reportName": "Report name",
  "status": "Succeeded",
  "percentComplete": 100,
  "resourceLocation": "...Mi9C5419i....PS4=/file",
  "resourceFileExtension": ".pptx",
  "expirationTime": "2021-12-09T10:26:11.586756Z"
}

Definitionen

Name	Beschreibung
Export	Ein Objekt, das die Details und den aktuellen Status eines Exportauftrags in eine Datei beschreibt
ExportState	Der aktuelle Status des Auftrags zum Exportieren in die Datei

Export

Ein Objekt, das die Details und den aktuellen Status eines Exportauftrags in eine Datei beschreibt

Name	Typ	Beschreibung
ResourceFileExtension	string	Die Erweiterung der exportierten Datei
createdDateTime	string	Startdatum und -uhrzeit des Auftrags zum Exportieren in die Datei
expirationTime	string	Ablaufdatum und -uhrzeit der Abruf-URL
id	string	Die Auftrags-ID für den Export in die Datei
lastActionDateTime	string	Datum und Uhrzeit der letzten Änderung am Export in den Dateiauftrag
percentComplete	integer	Auftragsfortschritt als Prozentsatz
reportId	string	Die ID des exportierten Berichts
reportName	string	Der Name des exportierten Berichts
resourceLocation	string	Die Abruf-URL für die exportierte Datei
status	ExportState	Der aktuelle Status des Auftrags zum Exportieren in die Datei

ExportState

Der aktuelle Status des Auftrags zum Exportieren in die Datei

Name	Typ	Beschreibung
Failed	string	Fehler beim Export in dateiauftrag
NotStarted	string	Der Export in dateiauftrag wurde nicht gestartet
Running	string	Der Export in Dateiauftrag wird ausgeführt.
Succeeded	string	Der Export in Dateiauftrag wurde erfolgreich abgeschlossen.
Undefined	string	Der Status des Dateiexportauftrags ist nicht definiert.

Freigeben über