View a markdown version of this page

Operazioni in blocco con risorse e modelli - AWS IoT SiteWise

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

Operazioni in blocco con risorse e modelli

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

Nota

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

Concetti e terminologia chiave

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

  • 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 iniziale 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

  • Top-level risorsa: una AWS IoT SiteWise risorsa che è possibile creare o aggiornare individualmente, ad esempio una risorsa o un modello di asset.

  • Sub-resource: 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 le risorse con successo. Esempi di metadati sono le definizioni degli asset e i modelli di asset.

  • metadati TransferJob: l'oggetto creato durante l'esecuzione. CreateMetadataTransferJob

Funzionalità supportate

Questo argomento spiega cosa puoi fare quando esegui un'operazione in blocco. Le operazioni in blocco supportano le seguenti funzionalità:

  • Top-level creazione di risorse: quando importi 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.

  • Top-level sostituzione di risorse: quando importi una risorsa o un modello di asset 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 asset, la nuova definizione sostituisce tutte le risorse secondarie, come proprietà, gerarchie o modelli compositi.

    Ad esempio, se si aggiorna 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à 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.