Partilhar via

Datasets - Get Refresh History In Group

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna o histórico de atualização do conjunto de dados especificado do workspace especificado.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

Dataset.ReadWrite.All ou Dataset.Read.All

Limitações

O histórico de atualização do OneDrive não é retornado. O chamador deve ter permissões de gravação no conjunto de dados. 

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

A ID do conjunto de dados
groupId
 path True

string (uuid)

A ID do workspace
$top
 query

integer

minimum: 1

O número solicitado de entradas no histórico de atualização. Se não for fornecido, o padrão será as últimas 60 entradas disponíveis.

Respostas

Nome Tipo Description
200 OK

Refreshes

OKEY

Exemplos

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "status": "Unknown",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
    }
  ]
}

Definições

Nome Description
Refresh

Uma entrada de histórico de atualização do Power BI
RefreshAttempt

O Power BI faz automaticamente várias tentativas de atualizar um conjunto de dados se ele tiver uma falha de atualização. Este objeto contém informações sobre cada tentativa de atualização.
RefreshAttemptType

O tipo de tentativa de atualização.
Refreshes

O wrapper de resposta OData para uma lista de histórico de atualizações do Power BI
RefreshType

O tipo de solicitação de atualização

Refresh

Objeto

Uma entrada de histórico de atualização do Power BI

Nome Tipo Description
endTime

string (date-time)

A data e a hora de término da atualização (pode estar vazia se uma atualização estiver em andamento) no formato UTC.
refreshAttempts

RefreshAttempt[]

A lista de tentativas de atualização.
refreshType

RefreshType

O tipo de solicitação de atualização
requestId

string

O identificador da solicitação de atualização. Forneça esse identificador em todas as solicitações de serviço.
serviceExceptionJson

string

Código de erro de falha no formato JSON (vazio se não houver erro)
startTime

string (date-time)

A data e a hora de início da atualização no formato UTC.
status

string

  • Unknown se o estado de conclusão for desconhecido ou se uma atualização estiver em andamento.
  • Completed para uma atualização concluída com êxito.
  • Failed para uma atualização malsucedida (serviceExceptionJson conterá o código de erro).
  • Disabled se a atualização estiver desabilitada por uma atualização seletiva.

RefreshAttempt

Objeto

O Power BI faz automaticamente várias tentativas de atualizar um conjunto de dados se ele tiver uma falha de atualização. Este objeto contém informações sobre cada tentativa de atualização.

Nome Tipo Description
attemptId

integer

O índice da tentativa de atualização.
endTime

string (date-time)

A data e a hora de término da tentativa de atualização. O valor será nulo se a tentativa de atualização estiver em andamento.
serviceExceptionJson

string

Código de erro de falha no formato JSON. Nulo se não houver erro.
startTime

string (date-time)

A data e a hora de início da tentativa de atualização.
type

RefreshAttemptType

O tipo de tentativa de atualização.

RefreshAttemptType

Enumeração

O tipo de tentativa de atualização.

Valor Description
Data

A tentativa de atualização de carregar dados no conjunto de dados.
Query

A tentativa de atualizar caches de consulta premium e blocos de dashboard.u

Refreshes

Objeto

O wrapper de resposta OData para uma lista de histórico de atualizações do Power BI

Nome Tipo Description
@odata.context

string

value

Refresh[]

A lista de histórico de atualizações

RefreshType

Enumeração

O tipo de solicitação de atualização

Valor Description
Scheduled

A atualização foi disparada por uma configuração de agendamento de atualização do conjunto de dados
OnDemand

A atualização foi disparada interativamente por meio do portal do Power BI
ViaApi

A atualização foi disparada por uma chamada à API
ViaXmlaEndpoint

A atualização foi disparada por meio do ponto de extremidade XMLA público do Power BI
ViaEnhancedApi

A atualização foi disparada por uma chamada à API REST de atualização aprimorada
OnDemandTraining

A atualização foi disparada interativamente por meio do portal do Power BI com treinamento automático de agregações