View a markdown version of this page

Exécuter une tâche d'exportation en masse - AWS IoT SiteWise
Exporter les métadonnées (console)Exporter les métadonnées (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.

Exécuter une tâche d'exportation en masse

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 en masse votre AWS IoT SiteWise contenu vers Amazon S3, vous pouvez spécifier des filtres pour limiter les modèles de ressources et les ressources spécifiques que vous souhaitez exporter.

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

Note

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

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

Exemple corps de requête 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:::amzn-s3-demo-bucket"
          }
      }
}

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 Opérations groupées Nouveau 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 un nom pour la tâche d'exportation. Il s'agit du nom utilisé pour le fichier exporté dans votre compartiment Amazon S3.

    • Choisissez vos ressources à exporter, ce qui définit les filtres pour la tâche :

      • 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 progéniture 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 d'actif à utiliser pour le filtre d'exportation.

        • (Facultatif) Ajoutez la progéniture, 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 SiteWise les 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'action AWS CLI d'exportation :

Exporter des données depuis AWS IoT SiteWise vers Amazon S3

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

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

    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 fichier du corps de votre demande pour l'utiliser à l'étape suivante. Dans cet exemple, le fichier est nommé createMetadataTransferJobExport.json.

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