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

Aggiorna modelli compositi personalizzati (componenti)

È possibile utilizzare il 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. Scegliete il componente che desiderate aggiornare.

  6. Scegli Modifica.

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

  8. Seleziona Save (Salva.

Aggiornate un modello composito personalizzato (AWS CLI)

Usa il 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. Replace (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 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 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.

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

      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 ulteriori informazioni, vedete l'DescribeAssetModelCompositeModeloperazione.

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

  3. Rimuovi tutte le coppie chiave-valore dall'JSONoggetto in update-custom-composite-model.json ad eccezione dei seguenti campi:

    • assetModelCompositeModelName

    • assetModelCompositeModelDescription(se presente)

    • assetModelCompositeModelProperties(se presente)

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

    • Cambia 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. Replace (Sostituisci) 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 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.