Condividi tramite


Datasets - Get Refresh History In Group

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

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo 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 del set di dati

groupId
path True

string

uuid

ID area di lavoro

$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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

{
  "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

{
  "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

{
  "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