Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Suivi de l'avancement des tâches
<a name="review-job-progress"></a>

## Consulter la progression et les détails des tâches (console)
<a name="review-job-progress-console"></a>

Consultez [Importer des métadonnées (console)](running-bulk-operations-import.md#import-metadata-console) ou [Exporter les métadonnées (console)](running-bulk-operations-export.md#export-metadata-console) pour démarrer une tâche groupée.

**Vue d'ensemble de l'avancement des tâches dans la AWS IoT SiteWise console :**

1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Choisissez **Bulk operations New** dans le volet de navigation.

1. Le tableau de **progression des tâches** de la AWS IoT SiteWise console affiche la liste des tâches exécutées en bloc.

1. La colonne **Type de tâche** indique s'il s'agit d'une tâche d'exportation ou d'importation. Les colonnes **Date d'importation** indiquent la date de début de la tâche.

1. La colonne **Status** affiche le statut de la tâche. Vous pouvez sélectionner une tâche pour en voir les détails.

1. La tâche sélectionnée affiche **Success** en cas de réussite, ou une liste d'échecs en cas d'échec de la tâche. Une description de l'erreur est également affichée pour chaque type de ressource.

**Vue d'ensemble des détails du job dans la AWS IoT SiteWise console :**

Le tableau de **progression des tâches** de la AWS IoT SiteWise console affiche la liste des tâches exécutées en bloc.

1. Choisissez un poste pour obtenir plus de détails.

1. Pour une tâche d'**importation**, `Data source ARN` représente l'emplacement du fichier d'importation sur Amazon S3.

1. Pour une tâche d'**exportation**, le `Data destination ARN` représente l'emplacement du fichier sur Amazon S3 après l'exportation.

1. Les `Status` et`Status reason`, fournissent des détails supplémentaires sur le travail en cours. Pour plus d’informations, consultez [Suivi de l'avancement des tâches et gestion des erreurs](jobs-progress-error-handling.md).

1. Le `Queued position` représente la position de la tâche dans la file d'attente des processus. Les tâches sont traitées une par une. Une position en file d'attente de 1 indique que le travail sera traité ensuite.

1.  La page de détails des tâches affiche également le nombre d'avancement des tâches.

   1. Les types de décompte de l'avancement des tâches sont les suivants :

     1. `Total resources`— Indique le nombre total d'actifs dans le processus de transfert.

     1. `Succeeded`— Indique le nombre d'actifs transférés avec succès au cours du processus.

     1. `Failed`— Indique le nombre d'actifs défaillants au cours du processus.

     1. `Skipped`— Indique le nombre d'actifs ignorés au cours du processus.

1. Un statut de tâche `PENDING` égal ou `VALIDATING` affiche la progression de toutes les tâches`–`. Cela indique que le nombre de progrès des tâches est en cours d'évaluation.

1. Un statut de tâche de `RUNNING` affiche le `Total resources` nombre de tâches soumises pour traitement. Les dénombrements détaillés (`Succeeded``Failed`, et`Skipped`) s'appliquent aux ressources traitées. La somme des dénombrements détaillés est inférieure au `Total resources` nombre, jusqu'à ce que le statut du poste soit `COMPLETED` ou`ERROR`.

1.  Si le statut d'une tâche est `COMPLETED` ou`ERROR`, le `Total resources` nombre est égal à la somme des dénombrements détaillés (`Succeeded``Failed`, et`Skipped`). 

1.  Si le statut d'une tâche est défini comme `ERROR` tel, consultez le tableau **des échecs des tâches** pour obtenir des informations détaillées sur les erreurs et les échecs spécifiques. Pour plus d’informations, consultez [Inspecter les détails de l'erreur (console)](inspect-errors.md#inspect-errors-console). 

## Examiner l'avancement et les détails du travail (AWS CLI)
<a name="review-job-progress-cli"></a>

Après avoir démarré une opération groupée, vous pouvez vérifier ou mettre à jour son statut à l'aide des actions d'API suivantes :
+ Pour récupérer des informations sur une tâche spécifique, utilisez l'action [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.

**Récupérez des informations avec l'`GetMetadataTransferJob`API :**

  1. Créez et exécutez une tâche de transfert. Appelez l'API `GetMetadataTransferJob`.  
**Example AWS CLI commande :**  

     ```
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id {{your_metadata_transfer_job_id}} \
             --region {{your_region}}
     ```

  1.  L'`GetMetadataTransferJob`API renvoie un `MetadataTransferJobProgress` objet avec les paramètres suivants : 
     + **SucceededCount** — Indique le nombre d'actifs transférés avec succès au cours du processus.
     + **FailedCount** — Indique le nombre d'actifs défaillants au cours du processus.
     + **SkippedCount** — Indique le nombre d'actifs ignorés au cours du processus.
     + **TotalCount** — Indique le nombre total d'actifs dans le processus de transfert.

     Ces paramètres indiquent l'état d'avancement de la tâche. Si le statut est le cas`RUNNING`, ils permettent de suivre le nombre de ressources restant à traiter.

     Si vous rencontrez des erreurs de validation du schéma, ou si **FailedCount** est supérieur ou égal à 1, l'état d'avancement de la tâche passe à. `ERROR` Un rapport d'erreur complet relatif à la tâche est placé dans votre compartiment Amazon S3. Pour plus d’informations, consultez [Inspectez les erreurs pour AWS IoT SiteWise](inspect-errors.md).
+ Pour répertorier les tâches en cours, utilisez l'action [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)API.

  Utilisez un fichier JSON pour filtrer les tâches renvoyées en fonction de leur état actuel. Consultez la procédure suivante :

  1. Pour spécifier les filtres que vous souhaitez utiliser, créez un fichier JSON AWS CLI d'entrée. Vous souhaitez utiliser :

     ```
     {
         "sourceType": "s3",
         "destinationType": "iottwinmaker",
         "filters": [{
             "state": "COMPLETED"
         }]
     }
     ```

     Pour obtenir la liste des `state` valeurs valides, consultez le *Guide [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)de référence de l'AWS IoT TwinMaker API*.

  1.  Utilisez le fichier JSON comme argument dans l' AWS CLI exemple de commande suivant :

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ Pour annuler une tâche, utilisez l'action [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)API. Cette API annule la tâche de transfert de métadonnées spécifique, sans affecter les ressources déjà exportées ou importées :

  ```
  aws iottwinmaker cancel-metadata-transfer-job \ 
          --region {{your_region}} \ 
          --metadata-transfer-job-id {{job-to-cancel-id}}
  ```