

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esegui un processo di esportazione in blocco
<a name="running-bulk-operations-export"></a>

 L'esportazione in blocco è l'azione di spostare i metadati da un' AWS IoT SiteWise area di lavoro a un bucket Amazon S3. 

Quando esegui un'esportazione in blocco dei tuoi AWS IoT SiteWise contenuti su Amazon S3, puoi specificare filtri per limitare i modelli e gli asset specifici che desideri esportare.

I filtri devono essere specificati in una `iotSiteWiseConfiguration` sezione all'interno della sezione delle fonti della richiesta JSON.

**Nota**  
 Puoi includere più filtri nella tua richiesta. L'operazione in blocco esporterà modelli di asset e asset che corrispondono a uno qualsiasi dei filtri.   
 Se non fornite alcun filtro, l'operazione in blocco esporta tutti i modelli e gli asset degli asset. 

**Example corpo della richiesta con filtri**  

```
{
      "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"
          }
      }
}
```

## Esporta metadati (console)
<a name="export-metadata-console"></a>

La procedura seguente spiega l'azione di esportazione della console:

**Creare un processo di esportazione in Console AWS IoT SiteWise**

1.  Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Scegli **Operazioni in blocco Nuove** dal pannello di navigazione.

1. Scegli **Nuova esportazione** per avviare il processo di esportazione.

1. Nella pagina **Esporta metadati**:
   +  Immettete un nome per il processo di esportazione. Questo è il nome usato per il file esportato nel tuo bucket Amazon S3. 
   + Scegliete le risorse da esportare, che imposta i filtri per il lavoro:
     + Esporta tutti gli asset e i modelli di asset. Utilizza i filtri sugli asset e sui modelli di asset.
     + Esporta risorse. Filtra in base alle tue risorse.
       + Seleziona la risorsa da utilizzare per il filtro di esportazione.
       + (Facoltativo) Aggiungete la progenie o il modello di asset associato.
     + Esporta modelli di asset. Filtra i tuoi modelli di asset.
       + Seleziona il modello di asset da utilizzare per il filtro di esportazione.
       + (Facoltativo) Aggiungi la progenie, l'asset associato o entrambi. 
     + Scegli **Next (Successivo)**.
   + Passa al bucket Amazon S3:
     + Scegli **Browse Amazon S3** per visualizzare il bucket e i file Amazon S3.
     + Passa al bucket Amazon S3 in cui deve essere inserito il file.
     + Scegli **Next (Successivo)**.
   + **Controlla il processo di esportazione e scegli Esporta.**

1. La pagina **Operazioni in blocco sui SiteWise metadati** di Console AWS IoT SiteWise mostra il processo di importazione appena creato nella tabella di **avanzamento dei lavori**.

Per i diversi modi di utilizzare i filtri durante l'esportazione dei metadati, consulta. [Esporta esempi di metadati](bulk-operations-export-filter-examples.md) 

## Esporta metadati ()AWS CLI
<a name="export-metadata-cli"></a>

La procedura seguente spiega l'azione di AWS CLI esportazione:

**Esportazione di dati AWS IoT SiteWise da Amazon S3**

1. Crea un file JSON con il corpo della richiesta. Il corpo della richiesta specifica l'origine e la destinazione del processo di trasferimento. L'esempio seguente mostra un esempio di corpo della richiesta:

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

   Assicurati di specificare il tuo bucket Amazon S3 come destinazione del processo di trasferimento dei metadati.
**Nota**  
Questo esempio esporterà tutti i tuoi modelli e asset di asset. Per limitare l'esportazione a modelli o asset specifici, potete includere filtri nel corpo della richiesta. Per ulteriori informazioni sull'applicazione dei filtri di esportazione, consulta[Esporta esempi di metadati](bulk-operations-export-filter-examples.md).

1. Salva il file del corpo della richiesta da utilizzare nel passaggio successivo. In questo esempio, il file è denominato `createMetadataTransferJobExport.json`.

1. Invoca il `CreateMetadataTransferJob` eseguendo il seguente AWS CLI comando:

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

   Sostituisci il file JSON di input `createMetadataTransferJobExport.json` con il tuo nome del file di trasferimento.