View a markdown version of this page

Aggiornare i modelli compositi personalizzati (componenti) - AWS IoT SiteWise
Aggiornare un componente (console)Aggiornate un modello composito personalizzato (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à.

Aggiornare i 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.

Aggiornare 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. Scegli il componente che desideri aggiornare.

  6. Scegli Modifica.

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

  8. Selezionare Salva.

Aggiornate un modello composito personalizzato (AWS CLI)

Utilizzate 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 personalizzato basato su un modello di componente, poiché il modello di componente di riferimento fornisce le proprietà associate.

Importante

Se si rimuove una proprietà da un modello composito personalizzato, AWS IoT SiteWise vengono eliminati tutti i dati precedenti relativi a tale proprietà. Non è possibile modificare il tipo o il tipo di dati di una proprietà esistente.

Per sostituire una proprietà del modello composito esistente con una nuova proprietà identicaname, effettuate le seguenti operazioni:

  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 sarà la name stessa della 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. Sostituisci composite-model-id con l'ID o l'ID esterno del modello composito personalizzato da aggiornare e asset-model-id con il modello di asset a cui è associato il modello composito personalizzato. Per ulteriori informazioni, consulta la Guida per l’utente di AWS IoT SiteWise .

    1. Esegui il comando seguente:

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

    2. Il comando precedente restituisce la definizione del modello composito corrispondente all'ultima versione del modello associato. Per un caso d'uso in cui un modello di asset è in uno FAILED stato, recuperate la definizione valida del modello corrispondente alla sua versione attiva per creare la richiesta di aggiornamento. Per informazioni dettagliate, vedi Versioni del modello di asset.

    3. Eseguite il comando seguente per recuperare la definizione del modello attivo:

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

    4. Per maggiori informazioni, vedi l'operazione DescribeAssetModelCompositeModel.

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

  3. Rimuovi tutte le coppie 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, consulta 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-id con l'ID del modello composito e asset-model-id con 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
Importante

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