Partager via


Datasets - Get Refresh History In Group

Retourne l’historique d’actualisation du jeu de données spécifié à partir de l’espace de travail spécifié.

Autorisations

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez Profils de principal de service dans Power BI Embedded.

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All

Limites

L’historique d’actualisation de OneDrive n’est pas retourné.

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
path True

string

ID du jeu de données

groupId
path True

string

uuid

L’ID de l’espace de travail

$top
query

integer

Nombre d’entrées demandé dans l’historique d’actualisation. Si elle n’est pas fournie, la valeur par défaut est les 60 dernières entrées disponibles.

Réponses

Nom Type Description
200 OK

Refreshes

Ok

Exemples

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

{
  "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

{
  "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

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

Définitions

Nom Description
Refresh

Une entrée d’historique d’actualisation Power BI

RefreshAttempt

Power BI effectue automatiquement plusieurs tentatives d’actualisation d’un jeu de données en cas d’échec de l’actualisation. Cet objet contient des informations sur chaque tentative d’actualisation.

RefreshAttemptType

Type de tentative d’actualisation.

Refreshes

Wrapper de réponse OData pour une liste d’historique d’actualisation Power BI

RefreshType

Type de demande d’actualisation

Refresh

Une entrée d’historique d’actualisation Power BI

Nom Type Description
endTime

string

Date et heure de fin de l’actualisation (peut être vide si une actualisation est en cours)

refreshAttempts

RefreshAttempt[]

Liste des tentatives d’actualisation.

refreshType

RefreshType

Type de demande d’actualisation

requestId

string

Identificateur de la demande d’actualisation. Fournissez cet identificateur dans toutes les demandes de service.

serviceExceptionJson

string

Code d’erreur d’échec au format JSON (vide si aucune erreur)

startTime

string

Date et heure de début de l’actualisation

status

string

  • Unknown si l’état d’achèvement est inconnu ou si une actualisation est en cours.
  • Completed pour une actualisation réussie.
  • Failed pour une actualisation infructueuse (serviceExceptionJson contient le code d’erreur).
  • Disabled si l’actualisation est désactivée par une actualisation sélective.

RefreshAttempt

Power BI effectue automatiquement plusieurs tentatives d’actualisation d’un jeu de données en cas d’échec de l’actualisation. Cet objet contient des informations sur chaque tentative d’actualisation.

Nom Type Description
attemptId

integer

Index de la tentative d’actualisation.

endTime

string

Date et heure de fin de la tentative d’actualisation. La valeur est void si la tentative d’actualisation est en cours.

serviceExceptionJson

string

Code d’erreur d’échec au format JSON. Void s’il n’y a pas d’erreur.

startTime

string

Date et heure de début de la tentative d’actualisation.

type

RefreshAttemptType

Type de tentative d’actualisation.

RefreshAttemptType

Type de tentative d’actualisation.

Nom Type Description
Data

string

Tentative d’actualisation pour charger des données dans le jeu de données.

Query

string

Tentative d’actualisation des caches de requêtes Premium et des vignettes de tableau de bord.u

Refreshes

Wrapper de réponse OData pour une liste d’historique d’actualisation Power BI

Nom Type Description
odata.context

string

value

Refresh[]

Liste de l’historique d’actualisation

RefreshType

Type de demande d’actualisation

Nom Type Description
OnDemand

string

L’actualisation a été déclenchée de manière interactive via le portail Power BI

OnDemandTraining

string

L’actualisation a été déclenchée de manière interactive via le portail Power BI avec la formation aux agrégations automatiques

Scheduled

string

L’actualisation a été déclenchée par un paramètre de planification de l’actualisation du jeu de données

ViaApi

string

L’actualisation a été déclenchée par un appel d’API

ViaEnhancedApi

string

L’actualisation a été déclenchée par un appel d’API REST d’actualisation amélioré

ViaXmlaEndpoint

string

L’actualisation a été déclenchée via le point de terminaison XMLA public Power BI