Aggiornamento di modelli compositi personalizzati (Componenti)

È possibile utilizzare l' AWS IoT SiteWise API per aggiornare un modello composito personalizzato o la AWS IoT SiteWise console per aggiornare i componenti.

Aggiornamento di un componente (console)

È possibile utilizzare la AWS IoT SiteWise console per aggiornare un componente.

Per aggiornare un componente (console)

1. Passare alla console AWS IoT SiteWise.

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

3. Scegliete il modello di asset in cui si trova il componente.

4. Nella scheda Proprietà, scegliete Componenti.

5. Scegliete il componente che desiderate aggiornare.

6. Scegli Modifica.

7. Nella pagina Modifica componente, effettuate una delle seguenti operazioni:

   • 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 Definizione di dati statici (attributi).

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

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

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

8. Seleziona Save (Salva.

Aggiornamento di un modello composito personalizzato (AWS CLI)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per aggiornare un modello composito personalizzato.

Per aggiornare il nome o la descrizione, utilizzate l'UpdateAssetModelCompositeModeloperazione. Solo per i modelli compositi personalizzati in linea, puoi anche aggiornare le proprietà. Non è possibile aggiornare le proprietà di un modello composito component-model-based personalizzato, poiché il modello di componente a cui fa riferimento fornisce le proprietà associate.

Importante

Se rimuovete una proprietà da un modello composito personalizzato, AWS IoT SiteWise elimina tutti i dati precedenti relativi a quella proprietà. Non è possibile modificare il tipo o il tipo di dati di una proprietà esistente.

Per sostituire una proprietà esistente del modello composito con una nuova con la stessa proprietàname, procedi come segue:

1. Inviate una UpdateAssetModelCompositeModel richiesta con l'intera proprietà esistente rimossa.

2. Invia una seconda UpdateAssetModelCompositeModel richiesta che includa la nuova proprietà. La nuova proprietà dell'asset avrà la name stessa di quella precedente e AWS IoT SiteWise genererà una nuova proprietà univocaid.

Per aggiornare un modello composito personalizzato (AWS CLI)

1. Per recuperare la definizione del modello composito esistente, eseguite il comando seguente. Sostituitelo composite-model-idcon l'ID o l'ID esterno del modello composito personalizzato da aggiornare e asset-model-idcon il modello di asset a cui è associato il modello composito personalizzato. Per ulteriori informazioni, consultate la Guida AWS IoT SiteWise per l'utente.

   aws iotsitewise describe-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id

   Per ulteriori informazioni, vedere l'DescribeAssetModelCompositeModeloperazione.

2. Crea un file chiamatoupdate-custom-composite-model.json, quindi copia la risposta del comando precedente nel file.

3. Rimuovi ogni coppia chiave-valore dall'oggetto JSON ad update-custom-composite-model.json eccezione dei seguenti campi:

   • assetModelCompositeModelName

   • assetModelCompositeModelDescription(se presente)

   • assetModelCompositeModelProperties(se presente)

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

   • Modificare il valore diassetModelCompositeModelName.

   • Aggiungi o assetModelCompositeModelDescription rimuovi o modificane il valore.

   • Solo per i modelli compositi personalizzati in linea: modifica, aggiungi o rimuovi qualsiasi proprietà del modello di asset inassetModelCompositeModelProperties.

   Per ulteriori informazioni sul formato richiesto per questo file, consultate la sintassi della richiesta per. UpdateAssetModelCompositeModel

5. Eseguite il comando seguente per aggiornare il modello composito personalizzato con la definizione memorizzata inupdate-custom-composite-model.json. Sostituiscilo composite-model-idcon l'ID del modello composito e asset-model-idcon l'ID del modello di asset in cui si trova.

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