Suivi de l'avancement des tâches

Consulter la progression et les détails de la tâche (console)

Consultez Importer des métadonnées (console) ou Exporter les métadonnées (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.

2. Choisissez Bulk operations New dans le volet de navigation.

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

4. 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.

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

6. 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.

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

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

4. Les Status etStatus 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.

5. 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.

6. 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.

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

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

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

7. 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.

8. Un statut de tâche de RUNNING affiche le Total resources nombre de tâches soumises pour traitement. Les chiffres détaillés (SucceededFailed, etSkipped) 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 ouERROR.

9. Si le statut d'une tâche est COMPLETED ouERROR, le Total resources nombre est égal à la somme des dénombrements détaillés (SucceededFailed, etSkipped).

10. Si le statut d'une tâche est défini comme ERROR tel, consultez le tableau des échecs des tâches pour plus de détails sur les erreurs et les échecs spécifiques. Pour plus d’informations, consultez Inspecter les détails de l'erreur (console).

Examiner l'avancement et les détails du travail (AWS CLI)

Après avoir démarré une opération en bloc, vous pouvez vérifier ou mettre à jour son statut en procédant comme API suit :

• Pour récupérer des informations sur une tâche spécifique, utilisez l' GetMetadataTransferJobAPIaction.

  Récupérez des informations avec GetMetadataTransferJob API :

  1. Créez et exécutez une tâche de transfert. Appelle le GetMetadataTransferJobAPI.

     Exemple AWS CLI commande :

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

  2. GetMetadataTransferJobAPIRenvoie 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 casRUNNING, ils permettent de suivre le nombre de ressources restant à traiter.

     Si vous rencontrez des erreurs de validation du schéma, ou si la valeur failedCountest supérieure ou égale à 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 répertorier les tâches en cours, utilisez l'ListMetadataTransferJobsAPIaction.

  Utilisez un JSON fichier 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 JSON fichier AWS CLI d'entrée. Vous souhaitez utiliser :

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

     Pour obtenir la liste des state valeurs valides, consultez ListMetadataTransferJobsFilterle Guide AWS IoT TwinMaker API de référence.

  2. Utilisez le JSON fichier 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'CancelMetadataTransferJobAPIaction. Cela 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