View a markdown version of this page

Esegui un processo di esportazione in blocco - AWS IoT SiteWise
Esporta i metadati (console)Esporta metadati (AWS CLI)

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

L'esportazione in blocco consiste nello spostare i metadati da AWS IoT SiteWise uno spazio 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 le risorse di asset specifici che desideri esportare.

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

Nota

Puoi includere più filtri nella tua richiesta. L'operazione in blocco esporterà modelli di asset e asset che corrispondono a qualsiasi filtro.

Se non fornisci alcun filtro, l'operazione in blocco esporta tutti i tuoi modelli di asset e gli 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 i metadati (console)

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

Crea un processo di esportazione in Console AWS IoT SiteWise

  1. Passare alla console AWS IoT SiteWise.

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

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

  4. Nella pagina dei metadati di esportazione:

    • Inserite un nome per il processo di esportazione. Questo è il nome utilizzato per il file esportato nel bucket Amazon S3.

    • Scegli le risorse da esportare, in questo modo vengono impostati i filtri per il lavoro:

      • Esporta tutte le risorse e i modelli di asset. Utilizza i filtri sugli asset e sui modelli di asset.

      • Esporta risorse. Filtra le 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 in base ai tuoi modelli di asset.

        • Seleziona il modello di asset da utilizzare per il filtro di esportazione.

        • (Facoltativo) Aggiungi la progenie o la risorsa associata o entrambi.

      • Scegli Avanti.

    • 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 Avanti.

    • Rivedi il processo di esportazione e scegli Esporta.

  5. La pagina Operazioni in blocco sui SiteWise metadati del 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. Esempi di metadati di esportazione

Esporta metadati (AWS CLI)

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

Esporta dati da AWS IoT SiteWise verso Amazon S3

  1. Crea un file JSON con il corpo della tua richiesta. Il corpo della richiesta specifica l'origine e la destinazione del processo di trasferimento. L'esempio seguente mostra un esempio del 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 bucket Amazon S3 come destinazione del processo di trasferimento dei metadati.

    Nota

    Questo esempio esporterà tutti i tuoi modelli di asset e asset. Per limitare l'esportazione a modelli di asset o asset specifici, puoi includere filtri nel corpo della richiesta. Per ulteriori informazioni sull'applicazione dei filtri di esportazione, consultaEsempi di metadati di esportazione.

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

  3. Richiamalo 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 di file di trasferimento.