Datasets - Get Refresh History

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce la cronologia degli aggiornamenti per il set di dati specificato dall'area di lavoro personale.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

Limitazioni

La cronologia degli aggiornamenti di OneDrive non viene restituita.

Esistono sempre tra 20 e 60 voci della cronologia degli aggiornamenti disponibili per ogni set di dati, a seconda del numero di aggiornamenti negli ultimi 3 giorni.
I 60 più recenti vengono conservati se sono tutti meno di 3 giorni. Le voci più di 3 giorni vengono eliminate quando sono presenti più di 20 voci.

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes

With optional parameters:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set di dati
$top	query		integer	Numero richiesto di voci nella cronologia degli aggiornamenti. Se non specificato, il valore predefinito è l'ultima voce disponibile 60.

Risposte

Nome	Tipo	Descrizione
200 OK	Refreshes	OK

Esempio

Completed refresh example

Failed refresh example

In-progress refresh example

Completed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/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/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/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"
    }
  ]
}

Definizioni

Nome	Descrizione
Refresh	Voce della cronologia degli aggiornamenti di Power BI
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.
RefreshAttemptType	Tipo di tentativo di aggiornamento.
Refreshes	Wrapper di risposta OData per un elenco della cronologia degli aggiornamenti di Power BI
RefreshType	Tipo di richiesta di aggiornamento

Refresh

Voce della cronologia degli aggiornamenti di Power BI

Nome	Tipo	Descrizione
endTime	string	Data e ora di fine dell'aggiornamento (può essere vuota se è in corso un aggiornamento)
refreshAttempts	RefreshAttempt[]	Elenco dei tentativi di aggiornamento.
refreshType	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 in formato JSON (vuoto se non viene visualizzato alcun errore)
startTime	string	Data e ora di inizio dell'aggiornamento
status	string	Unknown se lo stato di completamento è sconosciuto o è in corso un aggiornamento. Completed per un aggiornamento completato correttamente. Failed per un aggiornamento non riuscito (serviceExceptionJson conterrà il codice di errore). Disabled se l'aggiornamento è disabilitato da un aggiornamento selettivo.

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	Data e ora di fine del tentativo di aggiornamento. Il valore è void se il tentativo di aggiornamento è in corso.
serviceExceptionJson	string	Codice di errore non riuscito in formato JSON. Void se non è presente alcun errore.
startTime	string	Data e ora di inizio del tentativo di aggiornamento.
type	RefreshAttemptType	Tipo di tentativo di aggiornamento.

RefreshAttemptType

Tipo di tentativo di aggiornamento.

Nome	Tipo	Descrizione
Data	string	Tentativo di aggiornamento di caricare i dati nel set di dati.
Query	string	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

Nome	Tipo	Descrizione
OnDemand	string	L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI
OnDemandTraining	string	L'aggiornamento è stato attivato in modo interattivo tramite il portale di Power BI con il training automatico delle aggregazioni
Scheduled	string	L'aggiornamento è stato attivato da un'impostazione di pianificazione dell'aggiornamento del set di dati
ViaApi	string	L'aggiornamento è stato attivato da una chiamata API
ViaEnhancedApi	string	L'aggiornamento è stato attivato da una chiamata API REST di aggiornamento avanzato
ViaXmlaEndpoint	string	L'aggiornamento è stato attivato tramite l'endpoint XMLA pubblico di Power BI