Datasets - Get Refresh History In Group

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

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

Berechtigungen

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

Einschränkungen

Der OneDrive-Aktualisierungsverlauf wird nicht zurückgegeben. 

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

Arbeitsbereich-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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/{groupId}/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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 durch, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch.
RefreshAttemptType

Der Typ des Aktualisierungsversuchs.
Refreshes

OData-Antwortwrapper 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)
startTime

string

Startdatum und -uhrzeit der Aktualisierung
status

string

  • Unknown , wenn der Abschlusszustand 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 wird.

RefreshAttempt

Power BI führt automatisch mehrere Versuche durch, 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

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 kacheln Dashboard.u

Refreshes

OData-Antwortwrapper 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 erweiterten Aktualisierungs-REST-API-Aufruf ausgelöst.
ViaXmlaEndpoint

string

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