Operazioni in blocco con risorse e modelli

Per lavorare con un gran numero di asset o modelli di asset, utilizzate le operazioni in blocco per importare ed esportare in massa le risorse in una posizione diversa. Ad esempio, puoi creare un file di dati che definisce asset o modelli di asset in un bucket Amazon S3 e utilizzare l'importazione in blocco per crearli o aggiornarli. AWS IoT SiteWise In alternativa, se disponi di un gran numero di asset o modelli di asset AWS IoT SiteWise, puoi esportarli in Amazon S3.

Nota

Puoi eseguire operazioni in blocco AWS IoT SiteWise richiamando le operazioni nell' AWS IoT TwinMaker API. Puoi farlo senza configurare AWS IoT TwinMaker o creare un' AWS IoT TwinMaker area di lavoro. Tutto ciò di cui hai bisogno è un bucket Amazon S3 in cui inserire i tuoi contenuti. AWS IoT SiteWise

Argomenti

• Concetti e terminologia chiave
• Funzionalità supportate
• Prerequisiti per le operazioni in blocco
• Esecuzione di un processo di importazione in blocco
• Esecuzione di un processo di esportazione in blocco
• Monitoraggio dell'avanzamento dei lavori e gestione degli errori
• Importa esempi di metadati
• Esporta esempi di metadati
• AWS IoT SiteWise schema del processo di trasferimento dei metadati

Concetti e terminologia chiave

AWS IoT SiteWise le funzionalità di importazione ed esportazione in blocco si basano sui seguenti concetti e terminologia:

• Importazione: l'azione di spostare risorse o modelli di asset da un file in un bucket Amazon S3 a. AWS IoT SiteWise

• Esportazione: l'azione di spostare risorse o modelli di asset AWS IoT SiteWise da un bucket Amazon S3.

• Fonte: la posizione di partenza da cui desideri spostare i contenuti.

  Ad esempio, un bucket Amazon S3 è una fonte di importazione ed AWS IoT SiteWise è una fonte di esportazione.

• Destinazione: la posizione desiderata in cui desideri spostare i tuoi contenuti.

  Ad esempio, un bucket Amazon S3 è una destinazione di esportazione ed AWS IoT SiteWise è una destinazione di importazione.

• AWS IoT SiteWise Schema: questo schema viene utilizzato per importare ed esportare metadati da. AWS IoT SiteWise

• Risorsa di primo livello: una AWS IoT SiteWise risorsa che è possibile creare o aggiornare singolarmente, ad esempio una risorsa o un modello di risorsa.

• Risorsa secondaria: una risorsa annidata all'interno di una AWS IoT SiteWise risorsa di primo livello. Gli esempi includono proprietà, gerarchie e modelli compositi.

• Metadati: informazioni chiave necessarie per importare o esportare correttamente le risorse. Esempi di metadati sono le definizioni degli asset e i modelli di asset.

• metadataTransferJob: L'oggetto creato durante l'esecuzioneCreateMetadataTransferJob.

Funzionalità supportate

Questo argomento spiega cosa è possibile fare quando si esegue un'operazione in blocco. Le operazioni in blocco supportano le seguenti funzionalità:

• Creazione di risorse di primo livello: quando importate una risorsa o un modello di asset che non definisce un ID o il cui ID non corrisponde a quello di uno esistente, verrà creato come nuova risorsa.

• Sostituzione di risorse di primo livello: quando importate una risorsa o un modello di risorsa il cui ID corrisponde a uno già esistente, sostituirà la risorsa esistente.

• Creazione, sostituzione o eliminazione di sottorisorse: quando l'importazione sostituisce una risorsa di primo livello come una risorsa o un modello di risorsa, la nuova definizione sostituisce tutte le risorse secondarie, come proprietà, gerarchie o modelli compositi.

  Ad esempio, se aggiorni un modello di asset durante un'importazione in blocco e la versione aggiornata definisce una proprietà che non era presente nell'originale, viene creata una nuova proprietà. Se definisce una proprietà già esistente, la proprietà esistente verrà aggiornata. Se il modello di asset aggiornato omette una proprietà che era presente nell'originale, la proprietà viene eliminata.

• Nessuna eliminazione di risorse di primo livello: le operazioni in blocco non eliminano una risorsa o un modello di asset. Le operazioni in blocco si limitano a crearli o aggiornarli.