Freigeben über


Datasets - Get Refresh History In Group

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.

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
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

{
  "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

{
  "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

{
  "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

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

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

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

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

Name Typ Beschreibung
@odata.context

string

value

Refresh[]

Die Aktualisierungsverlaufsliste

RefreshType

Der Typ der Aktualisierungsanforderung

Wert Beschreibung
OnDemand

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

OnDemandTraining

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

Scheduled

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

ViaApi

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

ViaEnhancedApi

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

ViaXmlaEndpoint

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