Compartir a través de

Datasets - Get Refresh History

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

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

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

Limitaciones

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

Siempre hay entre 20 y 60 entradas del historial de actualización disponibles para cada conjunto de datos, en función del número de actualizaciones de los últimos 3 días.
Los 60 más recientes se conservan si todos tienen menos de 3 días de antigüedad. Las entradas de más de 3 días de antigüedad se eliminan cuando hay más de 20 entradas. 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
Con parámetros opcionales: 
GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes?$top={$top}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos
$top
 query

integer

minimum: 1

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

Respuestas

Nombre Tipo Description
200 OK

Refreshes

De acuerdo

Ejemplos

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Una 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 del historial de actualizaciones de Power BI
RefreshType

Tipo de solicitud de actualización

Refresh

Object

Una entrada del historial de actualización de Power BI

Nombre Tipo Description
endTime

string (date-time)

La fecha y hora de finalización de la actualización (puede estar vacía si una actualización está en curso) en formato UTC.
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 ningún error)
startTime

string (date-time)

La fecha y hora de inicio de la actualización en formato UTC.
status

string

  • Unknown si el estado de finalización es desconocido o si hay una actualización 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

Object

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

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

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

RefreshAttemptType

Tipo de intento de actualización.

RefreshAttemptType

Enumeración

Tipo de intento de actualización.

Valor Description
Data

La actualización intenta cargar datos en el conjunto de datos.
Query

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

Refreshes

Object

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

Nombre Tipo Description
@odata.context

string

value

Refresh[]

Lista del historial de actualizaciones

RefreshType

Enumeración

Tipo de solicitud de actualización

Valor Description
Scheduled

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

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

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

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

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

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