Freigeben über

Datasets - Get Refresh History

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

Gibt den Aktualisierungsverlauf für das angegebene Dataset aus "Mein Arbeitsbereich" zurück.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

Der OneDrive-Aktualisierungsverlauf wird nicht zurückgegeben.

Für jedes Dataset stehen immer zwischen 20 und 60 Aktualisierungsverlaufseinträge zur Verfügung, abhängig von der Anzahl der Aktualisierungen in den letzten 3 Tagen.
Die letzten 60 werden aufbewahrt, wenn sie alle weniger als 3 Tage alt sind. Einträge, die älter als 3 Tage sind, werden gelöscht, wenn mehr als 20 Einträge vorhanden sind. 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes?$top={$top}

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
$top
 query

integer

Die angeforderte Anzahl von Einträgen im Aktualisierungsverlauf. Wenn nicht angegeben, ist der Standardwert die letzten verfügbaren 60 Einträge.

Antworten

Name Typ Beschreibung
200 OK

Refreshes

OK

Beispiele

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "status": "Completed",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:40.153Z",
          "type": "Data"
        },
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:31:40.156Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "type": "Query"
        }
      ]
    }
  ]
}

Failed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
      "status": "Failed",
      "requestId": "11bf290a-346b-48b7-8973-c5df149337ff",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
          "type": "Data"
        }
      ]
    }
  ]
}

In-progress refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "status": "Unknown",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
    }
  ]
}

Definitionen

Name Beschreibung
Refresh

Ein Power BI-Aktualisierungsverlaufseintrag
RefreshAttempt

Power BI führt automatisch mehrere Versuche zum Aktualisieren eines Datasets durch, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType

Der Typ des Aktualisierungsversuchs.
Refreshes

Der OData-Antwort-Wrapper für eine Power BI-Aktualisierungsverlaufsliste
RefreshType

Der Typ der Aktualisierungsanforderung

Refresh

Ein Power BI-Aktualisierungsverlaufseintrag

Name Typ Beschreibung
endTime

string

Das Enddatum und die Uhrzeit der Aktualisierung (kann leer sein, wenn eine Aktualisierung ausgeführt wird)
refreshAttempts

RefreshAttempt[]

Die Liste der Aktualisierungsversuche.
refreshType

RefreshType

Der Typ der Aktualisierungsanforderung
requestId

string

Dies ist der Bezeichner der Aktualisierungsanforderung. Geben Sie diesen Bezeichner in allen Dienstanforderungen an.
serviceExceptionJson

string

Fehlerfehlercode im JSON-Format (leer, wenn kein Fehler vorhanden ist)
startTime

string

Startdatum und -uhrzeit der Aktualisierung
status

string

  • Unknown , wenn der Vervollständigungsstatus unbekannt ist oder eine Aktualisierung ausgeführt wird.
  • Completed für eine erfolgreich abgeschlossene Aktualisierung.
  • Failed für eine nicht erfolgreiche Aktualisierung (serviceExceptionJson enthält den Fehlercode).
  • Disabled , wenn die Aktualisierung durch eine selektive Aktualisierung deaktiviert ist.

RefreshAttempt

Power BI führt automatisch mehrere Versuche zum Aktualisieren eines Datasets durch, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.

Name Typ Beschreibung
attemptId

integer

Der Index des Aktualisierungsversuchs.
endTime

string

Das Enddatum und die Uhrzeit des Aktualisierungsversuchs. Der Wert ist ungültig, wenn der Aktualisierungsversuch ausgeführt wird.
serviceExceptionJson

string

Fehlerfehlercode im JSON-Format. Void, wenn kein Fehler vorliegt.
startTime

string

Das Startdatum und die Uhrzeit des Aktualisierungsversuchs.
type

RefreshAttemptType

Der Typ des Aktualisierungsversuchs.

RefreshAttemptType

Der Typ des Aktualisierungsversuchs.

Name Typ Beschreibung
Data

string

Der Aktualisierungsversuch, Daten in das Dataset zu laden.
Query

string

Der Versuch, Premium-Abfragecaches zu aktualisieren und Dashboard kacheln.u

Refreshes

Der OData-Antwort-Wrapper für eine Power BI-Aktualisierungsverlaufsliste

Name Typ Beschreibung
odata.context

string

value

Refresh[]

Liste des Aktualisierungsverlaufs

RefreshType

Der Typ der Aktualisierungsanforderung

Name Typ Beschreibung
OnDemand

string

Die Aktualisierung wurde interaktiv über das Power BI-Portal ausgelöst.
OnDemandTraining

string

Die Aktualisierung wurde interaktiv über das Power BI-Portal mit automatischem Aggregationstraining ausgelöst.
Scheduled

string

Die Aktualisierung wurde durch eine Einstellung des Datasetaktualisierungszeitplans ausgelöst.
ViaApi

string

Die Aktualisierung wurde durch einen API-Aufruf ausgelöst.
ViaEnhancedApi

string

Die Aktualisierung wurde durch einen Aufruf der erweiterten REST-API für die Aktualisierung ausgelöst.
ViaXmlaEndpoint

string

Die Aktualisierung wurde über den öffentlichen Power BI-XMLA-Endpunkt ausgelöst.