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
<a name="running-bulk-operations-export"></a>

 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. 

**Example 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)
<a name="export-metadata-console"></a>

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](https://console.aws.amazon.com/iotsitewise/).

1. Choisissez Opérations ** groupées Nouveau ** dans le volet de navigation.

1. Choisissez ** Nouvelle exportation ** pour démarrer le processus d'exportation.

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

1. 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, consultez[Exemples de métadonnées d'exportation](bulk-operations-export-filter-examples.md). 

## Exporter les métadonnées (AWS CLI)
<a name="export-metadata-cli"></a>

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, consultez[Exemples de métadonnées d'exportation](bulk-operations-export-filter-examples.md).

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

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