View a markdown version of this page

Suivi de l'avancement des tâches - AWS IoT SiteWise
Vérifier la progression et les détails de la tâche (console)Passez en revue l'avancement et les détails du travail (AWS CLI)

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

Vérifier 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.

Aperçu de l'avancement des tâches dans le AWS IoT SiteWise console :

  1. Accédez à la console AWS IoT SiteWise.

  2. Choisissez Opérations groupées Nouveau 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 liées aux opérations groupées.

  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 État affiche l'état de la tâche. Vous pouvez sélectionner une tâche pour voir les détails la concernant.

  6. La tâche sélectionnée affiche Succès en cas de réussite, ou une liste d'échecs si la tâche a échoué. Une description de l'erreur est également affichée pour chaque type de ressource.

Aperçu des détails du poste dans le AWS IoT SiteWise console :

Le tableau de progression des tâches de la AWS IoT SiteWise console affiche la liste des tâches liées aux opérations groupées.

  1. Choisissez une offre d'emploi pour en savoir plus.

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

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

  4. Les Status et fournissent Status reason des informations supplémentaires sur la tâche 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 la tâche sera traitée ensuite.

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

    1. Les types de progression 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 qui ont échoué au cours du processus.

      4. Skipped— Indique le nombre de ressources qui ont été ignorées au cours du processus.

  7. Un statut de tâche égal à PENDING ou VALIDATING affiche toutes les tâches comptabilisées pour leur avancement–. Cela indique que les chiffres de progression des emplois sont en cours d'évaluation.

  8. Le statut de la tâche RUNNING affiche le Total resources nombre, la tâche soumise 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 décompte, jusqu'à ce que le statut de la tâche soit COMPLETED ouERROR.

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

  10. Si le statut d'une tâche est définiERROR, consultez le tableau É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 des erreurs (console).

Passez en revue l'avancement et les détails du travail (AWS CLI)

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

    Récupérez des informations avec l'GetMetadataTransferJobAPI :

    1. Créez et exécutez une tâche de transfert. Appelez l'API GetMetadataTransferJob.

      Exemple AWS CLI commande :
      
aws iottwinmaker get-metadata-transfer-job \ 
        --metadata-transfer-job-id your_metadata_transfer_job_id \
        --region your_region

    2. L'GetMetadataTransferJobAPI 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 qui ont échoué au cours du processus.

      • SkippedCount  : indique le nombre de ressources ignorées 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 c'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 FailedCount est supérieur ou égal à 1, l'état d'avancement de la tâche passe à. ERROR Un rapport d'erreur complet pour la tâche est placé dans votre compartiment Amazon S3. Pour plus d’informations, consultez Inspectez les erreurs pour AWS IoT SiteWise.

  • Pour répertorier les tâches en cours, utilisez l'action d'ListMetadataTransferJobsAPI.

    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 ListMetadataTransferJobsFilter le Guide de référence des AWS IoT TwinMaker API.

    2. 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 de CancelMetadataTransferJob l'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