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 |
---|---|---|---|---|
dataset
|
path | True |
string |
Die Dataset-ID |
group
|
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 |
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 |
Refresh |
Power BI führt automatisch mehrere Versuche aus, ein Dataset zu aktualisieren, wenn ein Aktualisierungsfehler auftritt. Dieses Objekt enthält Informationen zu jedem Aktualisierungsversuch. |
Refresh |
Der Typ des Aktualisierungsversuchs. |
Refreshes |
Der OData-Antwortwrapper für eine Power BI-Aktualisierungsverlaufsliste |
Refresh |
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 |
Die Aktualisierungsversuchsliste. |
|
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 |
|
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 |
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. |