Datasets - Get Refresh History In Group

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

With optional parameters:

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

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

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

Datasets - Get Refresh History In Group

Autorisations

Étendue requise

Limites

Paramètres URI

Réponses

Exemples

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In-progress refresh example

Sample Request

Sample Response

Définitions

Refresh

RefreshAttempt

RefreshAttemptType

Refreshes

RefreshType

Ressources supplémentaires