Datasets - Get Refresh History

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí historii aktualizací pro zadanou datovou sadu z pracovního prostoru.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

Omezení

Historie aktualizací OneDrivu se nevrátí.

Pro každou datovou sadu je vždy k dispozici 20 až 60 položek historie aktualizací v závislosti na počtu aktualizací za poslední 3 dny.
Posledních 60 se zachová, pokud jsou všechny starší než 3 dny. Položky starší než 3 dny se odstraní, pokud existuje více než 20 položek.

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}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
$top	query		integer	Požadovaný počet položek v historii aktualizací. Pokud není k dispozici, výchozí hodnota je posledních 60 položek.

Odpovědi

Name	Typ	Description
200 OK	Refreshes	OK

Příklady

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"
    }
  ]
}

Definice

Name	Description
Refresh	Položka historie aktualizací Power BI
RefreshAttempt	Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.
RefreshAttemptType	Typ pokusu o aktualizaci.
Refreshes	Obálka odpovědi OData pro seznam historie aktualizací Power BI
RefreshType	Typ žádosti o aktualizaci

Refresh

Položka historie aktualizací Power BI

Name	Typ	Description
endTime	string	Koncové datum a čas aktualizace (pokud probíhá aktualizace, může být prázdné)
refreshAttempts	RefreshAttempt[]	Seznam pokusů o aktualizaci.
refreshType	RefreshType	Typ žádosti o aktualizaci
requestId	string	Identifikátor žádosti o aktualizaci. Zadejte tento identifikátor ve všech žádostech o služby.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON (prázdný, pokud žádná chyba není)
startTime	string	Počáteční datum a čas aktualizace
status	string	Unknown pokud je stav dokončení neznámý nebo probíhá aktualizace. Completed pro úspěšně dokončenou aktualizaci. Failed pro neúspěšnou aktualizaci (serviceExceptionJson bude obsahovat kód chyby). Disabled pokud je aktualizace zakázaná selektivní aktualizací.

RefreshAttempt

Power BI automaticky provede několik pokusů o aktualizaci datové sady, pokud dojde k selhání aktualizace. Tento objekt obsahuje informace o každém pokusu o aktualizaci.

Name	Typ	Description
attemptId	integer	Index pokusu o aktualizaci.
endTime	string	Koncové datum a čas pokusu o aktualizaci. Pokud probíhá pokus o aktualizaci, hodnota je neplatná.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON V případě, že nedojde k žádné chybě, je neplatná.
startTime	string	Počáteční datum a čas pokusu o aktualizaci.
type	RefreshAttemptType	Typ pokusu o aktualizaci.

RefreshAttemptType

Typ pokusu o aktualizaci.

Name	Typ	Description
Data	string	Aktualizace se pokusí načíst data do datové sady.
Query	string	Pokus o aktualizaci mezipaměti dotazů Premium a dlaždic řídicího panelu.u

Refreshes

Obálka odpovědi OData pro seznam historie aktualizací Power BI

Name	Typ	Description
odata.context	string
value	Refresh[]	Seznam historie aktualizací

RefreshType

Typ žádosti o aktualizaci

Name	Typ	Description
OnDemand	string	Aktualizace se aktivovala interaktivně prostřednictvím portálu Power BI.
OnDemandTraining	string	Aktualizace se aktivovala interaktivně prostřednictvím portálu Power BI s trénováním automatických agregací.
Scheduled	string	Aktualizace se aktivovala nastavením plánu aktualizace datové sady.
ViaApi	string	Aktualizace se aktivovala voláním rozhraní API.
ViaEnhancedApi	string	Aktualizace se aktivovala voláním rozhraní REST API rozšířené aktualizace.
ViaXmlaEndpoint	string	Aktualizace se aktivovala prostřednictvím veřejného koncového bodu XMLA Power BI.