Exécution d'une tâche d'exportation groupée

L'exportation en masse consiste à déplacer des métadonnées d'un AWS IoT SiteWise espace de travail vers un compartiment Amazon S3.

Lorsque vous exportez votre AWS IoT SiteWise contenu en masse vers Amazon S3, vous pouvez définir des filtres pour limiter les modèles d'actifs et les actifs spécifiques que vous souhaitez exporter.

Les filtres doivent être spécifiés dans une iotSiteWiseConfiguration section de la section sources de votre requête JSON.

Note

Vous pouvez inclure plusieurs filtres dans votre demande. L'opération groupée exportera les modèles d'actifs et les actifs correspondant à l'un des filtres.

Si vous ne fournissez aucun filtre, l'opération groupée exporte tous vos modèles et actifs d'actifs.

Exemple corps de la demande avec filtres

{
      "metadataTransferJobId": "your-transfer-job-id",
      "sources": [
       {
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
          "filters": [
           {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID"
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeAssets": true
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeOffspring": true
               }
             }
           ]
          }
        }
       ],
       "destination": {
          "type": "s3",
          "s3Configuration": {
            "location": "arn:aws:s3:::your-S3-bucket-location"
          }
      }
}

Exporter les métadonnées (console)

La procédure suivante explique l'action d'exportation de la console :

Créez une tâche d'exportation dans le Console AWS IoT SiteWise

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

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

3. Choisissez Nouvelle exportation pour démarrer le processus d'exportation.

4. Sur la page Exporter les métadonnées :

   • Entrez le nom de la tâche d'exportation. Il s'agit du nom utilisé pour le fichier exporté dans votre compartiment Amazon S3.

   • Choisissez les ressources à exporter, ce qui définit les filtres pour le travail :

     • Exportez tous les actifs et modèles d'actifs. Utilisez des filtres sur les actifs et les modèles d'actifs.

     • Exportez des actifs. Filtrez en fonction de vos actifs.

       • Sélectionnez la ressource à utiliser pour le filtre d'exportation.

       • (Facultatif) Ajoutez la descendance ou le modèle d'actif associé.

     • Exportez des modèles d'actifs. Filtrez en fonction de vos modèles d'actifs.

       • Sélectionnez le modèle de ressource à utiliser pour le filtre d'exportation.

       • (Facultatif) Ajoutez la progéniture, ou l'actif associé, ou les deux.

     • Choisissez Suivant.

   • Accédez au compartiment Amazon S3 :

     • Choisissez Parcourir Amazon S3 pour afficher le compartiment et les fichiers Amazon S3.

     • Accédez au compartiment Amazon S3 dans lequel le fichier doit être placé.

     • Choisissez Suivant.

   • Passez en revue la tâche d'exportation et choisissez Exporter.

5. La page Opérations groupées sur les SiteWise métadonnées Console AWS IoT SiteWise affiche la tâche d'importation nouvellement créée dans le tableau de progression des tâches.

Pour connaître les différentes manières d'utiliser les filtres lors de l'exportation de métadonnées, consultezExemples de métadonnées d'exportation.

Exporter les métadonnées (AWS CLI)

La procédure suivante explique l'opération AWS CLI d'exportation :

Exporter des données depuis AWS IoT SiteWise Amazon S3

1. Créez un fichier JSON avec le corps de votre requête. Le corps de la demande indique la source et la destination de la tâche de transfert. L'exemple suivant montre un exemple de corps de demande :

   
   {
       "metadataTransferJobId": "your-transfer-job-Id",
       "sources": [{
           "type": "iotsitewise"
       }],
       "destination": {
           "type": "s3",
           "s3Configuration": {
               "location": "arn:aws:s3:::your-S3-bucket-location"
           }
       }
   }

   Assurez-vous de spécifier votre compartiment Amazon S3 comme destination de la tâche de transfert de métadonnées.

   Note

   Cet exemple exportera tous vos modèles d'actifs et actifs. Pour limiter l'exportation à des modèles d'actifs ou à des actifs spécifiques, vous pouvez inclure des filtres dans le corps de votre demande. Pour plus d'informations sur l'application de filtres d'exportation, consultezExemples de métadonnées d'exportation.

2. Enregistrez le corps du fichier de votre demande pour l'utiliser à l'étape suivante. Dans cet exemple, le fichier est nommé createMetadataTransferJobExport.json.

3. Appelez le CreateMetadataTransferJob en exécutant la AWS CLI commande suivante :

   
   aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ 
            --cli-input-json file://createMetadataTransferJobExport.json
   

   Remplacez le fichier JSON d'entrée createMetadataTransferJobExport.json par votre propre nom de fichier de transfert.