Datasets - Get Refresh History In Group
Restituisce la cronologia di aggiornamento per il set di dati specificato dall'area di lavoro specificata.
Autorizzazioni
Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: profili entità servizio in Power BI Embedded.
Ambito obbligatorio
Dataset.ReadWrite.All o Dataset.Read.All
Limitazioni
La cronologia degli aggiornamenti di OneDrive non viene restituita.
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}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
dataset
|
path | True |
string |
ID set di dati |
group
|
path | True |
string (uuid) |
ID dell'area di lavoro |
$top
|
query |
integer minimum: 1 |
Numero richiesto di voci nella cronologia degli aggiornamenti. Se non specificato, il valore predefinito è l'ultima voce disponibile di 60. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Completed refresh example |
Failed refresh example |
In-progress refresh example |
Completed refresh example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Risposta di esempio
{
"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
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Risposta di esempio
{
"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
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Risposta di esempio
{
"value": [
{
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"status": "Unknown",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Refresh |
Voce della cronologia degli aggiornamenti di Power BI |
Refresh |
Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento. |
Refresh |
Tipo di tentativo di aggiornamento. |
Refreshes |
Wrapper di risposta OData per un elenco della cronologia degli aggiornamenti di Power BI |
Refresh |
Tipo di richiesta di aggiornamento |
Refresh
Voce della cronologia degli aggiornamenti di Power BI
Nome | Tipo | Descrizione |
---|---|---|
endTime |
string (date-time) |
Data e ora di fine dell'aggiornamento (può essere vuota se è in corso un aggiornamento) in formato UTC. |
refreshAttempts |
Elenco di tentativi di aggiornamento. |
|
refreshType |
Tipo di richiesta di aggiornamento |
|
requestId |
string |
Identificatore della richiesta di aggiornamento. Specificare questo identificatore in tutte le richieste di servizio. |
serviceExceptionJson |
string |
Codice errore errore in formato JSON (vuoto se non viene visualizzato alcun errore) |
startTime |
string (date-time) |
Data e ora di inizio dell'aggiornamento in formato UTC. |
status |
string |
|
RefreshAttempt
Power BI esegue automaticamente più tentativi di aggiornamento di un set di dati se si verifica un errore di aggiornamento. Questo oggetto contiene informazioni su ogni tentativo di aggiornamento.
Nome | Tipo | Descrizione |
---|---|---|
attemptId |
integer |
Indice del tentativo di aggiornamento. |
endTime |
string (date-time) |
Data e ora di fine del tentativo di aggiornamento. Il valore è void se il tentativo di aggiornamento è in corso. |
serviceExceptionJson |
string |
Codice errore errore in formato JSON. Void se non è presente alcun errore. |
startTime |
string (date-time) |
Data e ora di inizio del tentativo di aggiornamento. |
type |
Tipo di tentativo di aggiornamento. |
RefreshAttemptType
Tipo di tentativo di aggiornamento.
Valore | Descrizione |
---|---|
Data |
Tentativo di aggiornamento di caricare i dati nel set di dati. |
Query |
Tentativo di aggiornare le cache delle query Premium e i riquadri del dashboard.u |
Refreshes
Wrapper di risposta OData per un elenco della cronologia degli aggiornamenti di Power BI
Nome | Tipo | Descrizione |
---|---|---|
@odata.context |
string |
|
value |
Refresh[] |
Elenco cronologia aggiornamenti |
RefreshType
Tipo di richiesta di aggiornamento
Valore | Descrizione |
---|---|
OnDemand |
L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI |
OnDemandTraining |
L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI con training delle aggregazioni automatiche |
Scheduled |
L'aggiornamento è stato attivato da un'impostazione di pianificazione dell'aggiornamento del set di dati |
ViaApi |
L'aggiornamento è stato attivato da una chiamata API |
ViaEnhancedApi |
L'aggiornamento è stato attivato da una chiamata all'API REST di aggiornamento avanzato |
ViaXmlaEndpoint |
L'aggiornamento è stato attivato tramite l'endpoint XMLA pubblico di Power BI |