Esegui un processo di esportazione in blocco

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

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.

Esempio 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)

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.

2. Scegli Operazioni in blocco Nuove dal pannello di navigazione.

3. Scegli Nuova esportazione per avviare il processo di esportazione.

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

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

Esporta metadati ()AWS CLI

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

Esportazione di dati AWS IoT SiteWise da Amazon S3

1. Crea un JSON file 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, consultaEsporta esempi di metadati.

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

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

   Sostituite il JSON file di input createMetadataTransferJobExport.json con il vostro nome di file di trasferimento.