Datasets - Get Refresh History In Group

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí historii aktualizace pro zadanou datovou sadu ze zadaného pracovního prostoru.

Oprávnění

Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

Omezení

Historie aktualizací OneDrivu se nevrátí.

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
groupId	path	True	string uuid	ID pracovního prostoru
$top	query		integer	Požadovaný počet položek v historii aktualizace. Pokud není zadaný, 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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/{groupId}/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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 aktualizace 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 aktualizace Power BI

Name	Typ	Description
endTime	string	Koncové datum a čas aktualizace (může být prázdné, pokud aktualizace probíhá)
refreshAttempts	RefreshAttempt[]	Seznam pokusů o aktualizaci.
refreshType	RefreshType	Typ žádosti o aktualizaci
requestId	string	Identifikátor žádosti o aktualizaci. Tento identifikátor zadejte ve všech žádostech o služby.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON (prázdný, pokud žádná chyba neexistuje)
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ázána 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 void.
serviceExceptionJson	string	Kód chyby selhání ve formátu JSON Pokud 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ů úrovně Premium a dlaždic řídicího panelu

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 rozšířeným voláním rozhraní REST API pro aktualizaci.
ViaXmlaEndpoint	string	Aktualizace se aktivovala prostřednictvím veřejného koncového bodu XMLA Power BI.