Condividi tramite


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
datasetId
path True

string

ID set di dati

groupId
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

Refreshes

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

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 (date-time)

Data e ora di fine dell'aggiornamento (può essere vuota se è in corso un aggiornamento) in formato UTC.

refreshAttempts

RefreshAttempt[]

Elenco di 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 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

  • Unknown se lo stato di completamento è sconosciuto o se è 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 (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

RefreshAttemptType

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