Updating asset models and component models - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Updating asset models and component models

You can use the Amazon IoT SiteWise console or API to update an asset model or component model.

You can't change the type or data type of an existing property, or the window of an existing metric. You also can't change the type of the model from asset model to component model, or the other way around.

Important

  • If you remove a property from an asset model or component model, Amazon IoT SiteWise deletes all previous data for that property. For component models, this affects all asset models using that component model, so be especially careful to understand how widely your change may apply.

  • If you remove a hierarchy definition from an asset model, Amazon IoT SiteWise disassociates all assets in that hierarchy.

When you update an asset model, every asset based on that model reflects any changes that you make to the underlying model. Until the changes propagate, each asset has the UPDATING state. You must wait until those assets return to the ACTIVE state before you interact with them. During this time, the updated asset model's status will be PROPAGATING.

When you update a component model, every asset model that incorporates that component model reflects the changes. Until the component model changes propagate, each affected asset model has the UPDATING state, followed by PROPAGATING as it updates its associated assets, as described in the preceding paragraph. You must wait until those asset models return to the ACTIVE state before you interact with them. During this time, the updated component model's status will be PROPAGATING.

For more information, see Asset and model states.

Topics