Freigeben über

Datasets - Get Refresh History In Group

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt den Aktualisierungsverlauf für das angegebene Dataset aus dem angegebenen Arbeitsbereich zurück.

Erlaubnisse

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

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Begrenzungen

Der OneDrive-Aktualisierungsverlauf wird nicht zurückgegeben. Der Aufrufer muss über Schreibberechtigungen für das Dataset verfügen. 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
Mit optionalen Parametern: 
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes?$top={$top}

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
groupId
 path True

string (uuid)

Die Arbeitsbereichs-ID
$top
 query

integer

minimum: 1

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

OKAY

Beispiele

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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 aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType

Der Typ des Aktualisierungsversuchs.
Refreshes

Der OData-Antwortwrapper für eine Power BI-Aktualisierungsverlaufsliste
RefreshType

Der Typ der Aktualisierungsanforderung

Refresh

Objekt

Ein Power BI-Aktualisierungsverlaufseintrag

Name Typ Beschreibung
endTime

string (date-time)

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

RefreshAttempt[]

Die Aktualisierungsversuchsliste.
refreshType

RefreshType

Der Typ der Aktualisierungsanforderung
requestId

string

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

string

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

string (date-time)

Das Startdatum und die Uhrzeit der Aktualisierung im UTC-Format.
status

string

  • Unknown, wenn der Abschlussstatus 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

Objekt

Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.

Name Typ Beschreibung
attemptId

integer

Der Index des Aktualisierungsversuchs.
endTime

string (date-time)

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

string

Fehlerfehlercode im JSON-Format. Ungültig, wenn kein Fehler auftritt.
startTime

string (date-time)

Das Startdatum und die Uhrzeit des Aktualisierungsversuchs.
type

RefreshAttemptType

Der Typ des Aktualisierungsversuchs.

RefreshAttemptType

Enumeration

Der Typ des Aktualisierungsversuchs.

Wert Beschreibung
Data

Der Aktualisierungsversuch zum Laden von Daten in das Dataset.
Query

Der Versuch, Premium-Abfragecaches und Dashboardkacheln zu aktualisieren.u

Refreshes

Objekt

Der OData-Antwortwrapper für eine Power BI-Aktualisierungsverlaufsliste

Name Typ Beschreibung
@odata.context

string

value

Refresh[]

Die Aktualisierungsverlaufsliste

RefreshType

Enumeration

Der Typ der Aktualisierungsanforderung

Wert Beschreibung
Scheduled

Die Aktualisierung wurde durch eine Einstellung für die Datensatzaktualisierung ausgelöst.
OnDemand

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

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

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

Die Aktualisierung wurde durch einen erweiterten Aktualisierungs-REST-API-Aufruf ausgelöst.
OnDemandTraining

Die Aktualisierung wurde interaktiv über das Power BI-Portal mit automatischen Aggregationsschulungen ausgelöst.