Condividi tramite

Datasets - Get Refresh History In Group

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
v1.0

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
Con parametri facoltativi: 
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

Codice di stato:
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

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

Codice di stato:
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

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

Codice di stato:
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

Object

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

Object

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

Enumerazione

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

Object

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

Enumerazione

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