Datasets - Get Refresh History In Group

  • Referencia
Service:
Power BI REST APIs
API Version:
v1.0

Devuelve el historial de actualización del conjunto de datos especificado del área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

Limitaciones

No se devuelve el historial de actualización de OneDrive. 

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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos
groupId
 path True

string

uuid

Identificador del área de trabajo
$top
 query

integer

Número solicitado de entradas en el historial de actualización. Si no se proporciona, el valor predeterminado es las últimas 60 entradas disponibles.

Respuestas

Nombre Tipo Description
200 OK

Refreshes

Aceptar

Ejemplos

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

Definiciones

Nombre Description
Refresh

Entrada del historial de actualización de Power BI
RefreshAttempt

Power BI realiza automáticamente varios intentos de actualizar un conjunto de datos si experimenta un error de actualización. Este objeto contiene información sobre cada intento de actualización.
RefreshAttemptType

Tipo de intento de actualización.
Refreshes

Contenedor de respuesta de OData para una lista de historial de actualizaciones de Power BI
RefreshType

Tipo de solicitud de actualización

Refresh

Entrada del historial de actualización de Power BI

Nombre Tipo Description
endTime

string

La fecha y hora de finalización de la actualización (puede estar vacía si hay una actualización en curso)
refreshAttempts

RefreshAttempt[]

Lista de intentos de actualización.
refreshType

RefreshType

Tipo de solicitud de actualización
requestId

string

Identificador de la solicitud de actualización. Proporcione este identificador en todas las solicitudes de servicio.
serviceExceptionJson

string

Código de error en formato JSON (vacío si no hay error)
startTime

string

Fecha y hora de inicio de la actualización
status

string

  • Unknown si el estado de finalización es desconocido o una actualización está en curso.
  • Completed para una actualización completada correctamente.
  • Failed para una actualización incorrecta (serviceExceptionJson contendrá el código de error).
  • Disabled si la actualización está deshabilitada por una actualización selectiva.

RefreshAttempt

Power BI realiza automáticamente varios intentos de actualizar un conjunto de datos si experimenta un error de actualización. Este objeto contiene información sobre cada intento de actualización.

Nombre Tipo Description
attemptId

integer

Índice del intento de actualización.
endTime

string

Fecha y hora de finalización del intento de actualización. El valor es void si el intento de actualización está en curso.
serviceExceptionJson

string

Código de error de error en formato JSON. Void si no hay ningún error.
startTime

string

Fecha y hora de inicio del intento de actualización.
type

RefreshAttemptType

Tipo de intento de actualización.

RefreshAttemptType

Tipo de intento de actualización.

Nombre Tipo Description
Data

string

El intento de actualización de cargar datos en el conjunto de datos.
Query

string

El intento de actualizar las cachés de consultas Premium y los iconos del panel.u

Refreshes

Contenedor de respuesta de OData para una lista de historial de actualizaciones de Power BI

Nombre Tipo Description
odata.context

string

value

Refresh[]

Lista del historial de actualización

RefreshType

Tipo de solicitud de actualización

Nombre Tipo Description
OnDemand

string

La actualización se desencadenó de forma interactiva a través del portal de Power BI
OnDemandTraining

string

La actualización se desencadenó de forma interactiva a través del portal de Power BI con entrenamiento de agregaciones automáticas
Scheduled

string

La actualización se desencadenó mediante una configuración de programación de actualización del conjunto de datos
ViaApi

string

La actualización se desencadenó mediante una llamada API
ViaEnhancedApi

string

La actualización se desencadenó mediante una llamada a la API REST de actualización mejorada.
ViaXmlaEndpoint

string

La actualización se desencadenó a través del punto de conexión XMLA público de Power BI