Datasets - Get Refresh History In Group

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Zwraca historię odświeżania dla określonego zestawu danych z określonego obszaru roboczego.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

Historia odświeżania usługi OneDrive nie jest zwracana. 

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych
groupId
 path True

string

uuid

Identyfikator obszaru roboczego
$top
 query

integer

Żądana liczba wpisów w historii odświeżania. Jeśli nie zostanie podana, wartość domyślna to ostatnie dostępne 60 wpisów.

Odpowiedzi

Nazwa Typ Opis
200 OK

Refreshes

OK

Przykłady

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

Definicje

Nazwa Opis
Refresh

Wpis historii odświeżania usługi Power BI
RefreshAttempt

Usługa Power BI automatycznie podejmuje wiele prób odświeżenia zestawu danych, jeśli wystąpi błąd odświeżania. Ten obiekt zawiera informacje o każdej próbie odświeżenia.
RefreshAttemptType

Typ próby odświeżenia.
Refreshes

Otoka odpowiedzi OData dla listy historii odświeżania usługi Power BI
RefreshType

Typ żądania odświeżania

Refresh

Wpis historii odświeżania usługi Power BI

Nazwa Typ Opis
endTime

string

Data i godzina zakończenia odświeżania (może być pusta, jeśli odświeżanie jest w toku)
refreshAttempts

RefreshAttempt[]

Lista prób odświeżenia.
refreshType

RefreshType

Typ żądania odświeżania
requestId

string

Identyfikator żądania odświeżania. Podaj ten identyfikator we wszystkich żądaniach obsługi.
serviceExceptionJson

string

Kod błędu błędu w formacie JSON (pusty, jeśli nie wystąpił błąd)
startTime

string

Data i godzina rozpoczęcia odświeżania
status

string

  • Unknown jeśli stan ukończenia jest nieznany lub trwa odświeżanie.
  • Completed pomyślnie ukończono odświeżanie.
  • Failed w przypadku nieudanego odświeżania (serviceExceptionJson będzie zawierać kod błędu).
  • Disabled jeśli odświeżanie jest wyłączone przez selektywne odświeżanie.

RefreshAttempt

Usługa Power BI automatycznie podejmuje wiele prób odświeżenia zestawu danych, jeśli wystąpi błąd odświeżania. Ten obiekt zawiera informacje o każdej próbie odświeżenia.

Nazwa Typ Opis
attemptId

integer

Indeks próby odświeżenia.
endTime

string

Data i godzina zakończenia próby odświeżenia. Wartość jest unieważniona, jeśli próba odświeżenia jest w toku.
serviceExceptionJson

string

Kod błędu błędu w formacie JSON. Unieważnij, jeśli nie ma błędu.
startTime

string

Data i godzina rozpoczęcia próby odświeżenia.
type

RefreshAttemptType

Typ próby odświeżenia.

RefreshAttemptType

Typ próby odświeżenia.

Nazwa Typ Opis
Data

string

Odświeżanie próbuje załadować dane do zestawu danych.
Query

string

Próba odświeżenia pamięci podręcznych zapytań w warstwie Premium i kafelków pulpitu nawigacyjnego.u

Refreshes

Otoka odpowiedzi OData dla listy historii odświeżania usługi Power BI

Nazwa Typ Opis
odata.context

string

value

Refresh[]

Lista historii odświeżania

RefreshType

Typ żądania odświeżania

Nazwa Typ Opis
OnDemand

string

Odświeżanie zostało wyzwolone interaktywnie za pośrednictwem portalu usługi Power BI
OnDemandTraining

string

Odświeżanie zostało wyzwolone interaktywnie za pośrednictwem portalu usługi Power BI z automatycznym trenowanie agregacji
Scheduled

string

Odświeżanie zostało wyzwolone przez ustawienie harmonogramu odświeżania zestawu danych
ViaApi

string

Odświeżanie zostało wyzwolone przez wywołanie interfejsu API
ViaEnhancedApi

string

Odświeżanie zostało wyzwolone przez ulepszone wywołanie interfejsu API REST odświeżania
ViaXmlaEndpoint

string

Odświeżanie zostało wyzwolone za pośrednictwem publicznego punktu końcowego XMLA usługi Power BI