Udostępnij przez

Datasets - Get Refresh History In Group

Usługa:
Power BI REST APIs
Wersja interfejsu API:
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 usłudze Power BI Embedded.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

Historia odświeżania usługi OneDrive nie jest zwracana. Obiekt wywołujący musi mieć uprawnienia do zapisu w zestawie danych. 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
Z parametrami opcjonalnymi: 
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

minimum: 1

Żą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

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Przykładowa odpowiedź

Kod stanu:
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

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Przykładowa odpowiedź

Kod stanu:
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

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Przykładowa odpowiedź

Kod stanu:
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

Objekt

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

Nazwa Typ Opis
endTime

string (date-time)

Data i godzina zakończenia odświeżania (może być pusta, jeśli odświeżanie jest w toku) w formacie UTC.
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 ma błędu)
startTime

string (date-time)

Data i godzina rozpoczęcia odświeżania w formacie UTC.
status

string

  • Unknown, jeśli stan ukończenia jest nieznany lub trwa odświeżanie.
  • Completed pomyślnego ukończenia odświeżania.
  • 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

Objekt

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 (date-time)

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

string

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

string (date-time)

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

RefreshAttemptType

Typ próby odświeżenia.

RefreshAttemptType

Wyliczanie

Typ próby odświeżenia.

Wartość Opis
Data

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

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

Refreshes

Objekt

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

Wyliczanie

Typ żądania odświeżania

Wartość Opis
Scheduled

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

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

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

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

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

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