Aggiorna i modelli degli asset e i modelli dei componenti

Utilizzate la AWS IoT SiteWise console o API per aggiornare un modello di asset o un modello di componente.

Non puoi modificare il tipo o il tipo di dati di una proprietà esistente o la finestra di una metrica esistente. Inoltre, non è possibile modificare il tipo di modello da modello di asset a modello di componenti o viceversa.

Importante

• Se rimuovete una proprietà da un modello di asset o da un modello di componente, AWS IoT SiteWise elimina tutti i dati precedenti relativi a quella proprietà. Per quanto riguarda i modelli a componenti, ciò influisce su tutti i modelli di asset che utilizzano quel modello di componenti, quindi prestate particolare attenzione a capire in che misura la modifica può essere applicata.

• Se rimuovete una definizione di gerarchia da un modello di asset, AWS IoT SiteWise dissocia tutti gli asset in quella gerarchia.

Quando aggiorni un modello, anche gli asset basati su quel modello assimilano le modifiche apportate. Fino a quando le modifiche non si propagano, ogni asset ha lo stato UPDATING. È necessario attendere fino a quando gli asset ritornano nello stato ACTIVE prima di poter interagire con loro. In questo lasso di tempo, lo stato del modello di asset aggiornato sarà PROPAGATING.

Quando aggiornate un modello di componente, ogni modello di asset che incorpora quel modello di componente riflette le modifiche. Fino a quando le modifiche al modello di componente non si propagano, ogni modello di asset interessato presenta UPDATING lo stato, seguito dall'PROPAGATINGaggiornamento degli asset associati, come descritto nel paragrafo precedente. È necessario attendere che tali modelli di asset tornino allo ACTIVE stato precedente prima di interagire con essi. Durante questo periodo, lo stato del modello di componente aggiornato saràPROPAGATING.

Per ulteriori informazioni, consulta Stati di asset e modelli.

Aggiornamento di un modello di asset o componente (console)

È possibile utilizzare la AWS IoT SiteWise console per aggiornare un modello di asset o un modello di componente.

Per aggiornare un modello di asset o un modello di componente (console)

1. Passare alla console AWS IoT SiteWise.

2. Nel riquadro di navigazione selezionare Models (Modelli).

3. Scegliete il modello di asset o il modello di componente da aggiornare.

4. Scegli Modifica.

5. Nella pagina Modifica modello esegui una delle operazioni seguenti:

   • In Dettagli del modello modifica il nome del modello.

   • Modifica una delle definizioni degli attributi. Non è possibile modificare il tipo di dati degli attributi esistenti. Per ulteriori informazioni, consulta Definire dati statici (attributi).

   • Modifica una delle definizioni di misurazione. Non è possibile modificare il tipo di dati delle misurazioni esistenti. Per ulteriori informazioni, consulta Definisci i flussi di dati provenienti dalle apparecchiature (misurazioni).

   • Modifica una delle definizioni di trasformazione. Per ulteriori informazioni, consulta Trasforma i dati (trasformazioni).

   • Modifica una delle definizioni di parametro. Non è possibile modificare l'intervallo di tempo dei parametri esistenti. Per ulteriori informazioni, consulta Aggrega i dati provenienti da proprietà e altre risorse (metriche).

   • (Solo modelli di asset) Modificate una qualsiasi definizione della gerarchia. Non è possibile modificare il modello di gerarchia delle gerarchie esistenti. Per ulteriori informazioni, consulta Definite le gerarchie dei modelli di asset.

6. Seleziona Save (Salva.

Nota

Le richieste di aggiornamento effettuate nella console vengono rifiutate se un altro utente aggiorna correttamente il modello di asset dall'ultima apertura della pagina Modifica modello. La console richiede all'utente di aggiornare la pagina Modifica modello per recuperare il modello aggiornato. È necessario effettuare nuovamente gli aggiornamenti e riprovare a salvare. Per ulteriori dettagli, consulta Blocco ottimistico per le scritture dei modelli di asset.

Aggiornate un modello di asset o componente ()AWS CLI

Utilizzate il AWS Command Line Interface (AWS CLI) per aggiornare un modello di asset o un modello di componente.

Utilizzate il UpdateAssetModelAPIper aggiornare il nome, la descrizione e le proprietà di un modello di asset o di un modello di componente. Solo per i modelli di asset, è possibile aggiornare le gerarchie. Specifica i seguenti parametri:

• assetModelId— L'ID della risorsa. Questo è l'ID effettivo nel UUID formato, o externalId:myExternalId se ne ha uno. Per ulteriori informazioni, consulta Oggetti di riferimento con oggetti esterni IDs nella Guida per l'utente di AWS IoT SiteWise .

Specificate il modello aggiornato nel payload. Per ulteriori informazioni sul formato previsto di un modello di asset o di un modello di componente, vedereCreazione di modelli di asset.

avvertimento

UpdateAssetModelAPISovrascrive il modello esistente con il modello fornito nel payload. Per evitare di eliminare le proprietà o le gerarchie del modello, è necessario includere le relative definizioni nel payload IDs del modello aggiornato. Per informazioni su come interrogare la struttura esistente del modello, consultate l'operazione. DescribeAssetModel

Nota

La procedura seguente può aggiornare solo modelli compositi di tipoAWS/ALARM. Se desideri aggiornare i modelli CUSTOM compositi, usa UpdateAssetModelCompositeModelinvece. Per ulteriori informazioni, consulta Aggiorna modelli compositi personalizzati (componenti).

Per aggiornare un modello di asset o un modello di componente (AWS CLI)

1. Eseguite il comando seguente per recuperare la definizione del modello esistente. Replace (Sostituisci) asset-model-id con l'ID o l'ID esterno del modello di asset o del modello di componente da aggiornare.

   aws iotsitewise describe-asset-model --asset-model-id asset-model-id

   Il comando precedente restituisce la definizione del modello corrispondente all'ultima versione del modello.

   Per un caso d'uso in cui un modello di asset si trova in uno FAILED stato, recuperate la definizione di modello valida corrispondente alla sua versione attiva per creare la richiesta di aggiornamento. Per informazioni dettagliate, vedi Versioni del modello di asset. Eseguite il comando seguente per recuperare la definizione attiva del modello:

   aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE 

   L'operazione restituisce una risposta che contiene i dettagli del modello. La risposta ha la seguente struttura.

   {
       "assetModelId": "String",
       "assetModelArn": "String",
       "assetModelName": "String",
       "assetModelDescription": "String",
       "assetModelProperties": Array of AssetModelProperty,
       "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
       "assetModelCompositeModels": Array of AssetModelCompositeModel,
       "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary,
       "assetModelCreationDate": "String",
       "assetModelLastUpdateDate": "String",
       "assetModelStatus": {
         "state": "String",
         "error": {
           "code": "String",
           "message": "String"
         },
       "assetModelType": "String"
       },
       "assetModelVersion": "String",
       "eTag": "String"
   }

   Per ulteriori informazioni, vedete l'DescribeAssetModeloperazione.

2. Crea un file denominato update-asset-model.json e copia la risposta del comando precedente nel file.

3. Rimuovi le seguenti coppie chiave-valore dall'JSONoggetto in: update-asset-model.json

   • assetModelId

   • assetModelArn

   • assetModelCompositeModelSummaries

   • assetModelCreationDate

   • assetModelLastUpdateDate

   • assetModelStatus

   • assetModelType

   • assetModelVersion

   • eTag

   L'UpdateAssetModeloperazione prevede un payload con la seguente struttura:

   {
     "assetModelName": "String",
     "assetModelDescription": "String",
     "assetModelProperties": Array of AssetModelProperty,
     "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
     "assetModelCompositeModels": Array of AssetModelCompositeModel
   }

4. In update-asset-model.json, effettua una delle seguenti operazioni:

   • Modifica il nome del modello di asset (assetModelName).

   • Modifica, aggiungi o rimuovi la descrizione del modello di asset (assetModelDescription).

   • Modifica, aggiungi o rimuovi qualsiasi proprietà del modello di asset (assetModelProperties). Non è possibile modificare l'elemento dataType delle proprietà esistenti o l'elemento window dei parametri esistenti. Per ulteriori informazioni, consulta Definite le proprietà dei dati.

   • Modifica, aggiungi o rimuovi una delle gerarchie del modello di asset (assetModelHierarchies). Non è possibile modificare l'elemento childAssetModelId delle gerarchie esistenti. Per ulteriori informazioni, consulta Definite le gerarchie dei modelli di asset.

   • Modifica, aggiungi o rimuovi uno qualsiasi dei modelli compositi di type AWS/ALARM () assetModelCompositeModels del modello di asset. Gli allarmi monitorano altre proprietà in modo da poter identificare quando le apparecchiature o i processi richiedono attenzione. Ogni definizione di allarme è un modello composito che standardizza l'insieme di proprietà utilizzate dall'allarme. Per ulteriori informazioni, consulta Monitora i dati con allarmi e Definisci gli allarmi sui modelli di asset.

5. Esegui il comando seguente per aggiornare il modello di asset con la definizione memorizzata in update-asset-model.json. Replace (Sostituisci) asset-model-id con l'ID del modello di asset:

   aws iotsitewise update-asset-model \
     --asset-model-id asset-model-id \
     --cli-input-json file://model-payload.json

Importante

Quando più utenti aggiornano un modello di asset contemporaneamente, le modifiche di un utente possono essere inavvertitamente sovrascritte da un altro utente. Per evitare ciò, è necessario definire una richiesta di aggiornamento condizionale. Per informazioni, consulta Blocco ottimistico per le scritture dei modelli di asset.