Actualización de modelos compuestos personalizados (componentes) - AWS IoT SiteWise
Actualización de un componente (consola)Actualización de un modelo compuesto personalizado (AWS CLI)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Actualización de modelos compuestos personalizados (componentes)

Puede utilizar la AWS IoT SiteWise API para actualizar un modelo compuesto personalizado o la AWS IoT SiteWise consola para actualizar los componentes.

Actualización de un componente (consola)

Puede utilizar la AWS IoT SiteWise consola para actualizar un componente.

Actualización de un componente (consola)

  1. Vaya a la consola de AWS IoT SiteWise.

  2. En el panel de navegación, elija Models (Modelos).

  3. Elija el modelo de activos en el que se encuentra el componente.

  4. En la pestaña Propiedades, elija Componentes.

  5. Elija el componente que desea actualizar.

  6. Seleccione Editar.

  7. En la página Editar componente, lleve a cabo alguna de las siguientes operaciones:

  8. Seleccione Save.

Actualización de un modelo compuesto personalizado (AWS CLI)

Utilice el AWS Command Line Interface (AWS CLI) para actualizar un modelo compuesto personalizado.

Para actualizar el nombre o la descripción, utilice la UpdateAssetModelCompositeModeloperación. Solo en el caso de los modelos compuestos personalizados en línea, también puede actualizar las propiedades. No puede actualizar las propiedades de un modelo compuesto component-model-based personalizado porque el modelo de componentes al que se hace referencia proporciona las propiedades asociadas.

importante

Si elimina una propiedad de un modelo compuesto personalizado, AWS IoT SiteWise elimina todos los datos anteriores de esa propiedad. No se puede cambiar el tipo o el tipo de datos de una propiedad existente.

Para reemplazar la propiedad de un modelo compuesto existente por otra nueva con el mismo name, haga lo siguiente:

  1. Envíe una solicitud UpdateAssetModelCompositeModel con toda la propiedad existente eliminada.

  2. Envía una segunda solicitud UpdateAssetModelCompositeModel que incluya la nueva propiedad. La nueva propiedad del activo tendrá la name misma que la anterior y AWS IoT SiteWise generará una nueva propiedad únicaid.

Actualización de un modelo compuesto personalizado (AWS CLI)

  1. Para recuperar la definición del modelo compuesto existente, ejecute el siguiente comando. composite-model-idSustitúyalo por el ID o el ID externo del modelo compuesto personalizado que se va a actualizar y asset-model-id por el modelo de activos al que está asociado el modelo compuesto personalizado. Para obtener más información, consulte la Guía del usuario de AWS IoT SiteWise .

    1. Ejecute el siguiente comando:

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

    2. El comando anterior devuelve la definición del modelo compuesto correspondiente a la última versión del modelo asociado. Para un caso de uso en el que un modelo de activos esté en estado FAILED, recupere la definición del modelo válida correspondiente a su versión activa para crear su solicitud de actualización. Para obtener más información, consulte Versiones de modelos de activos.

    3. Ejecute el siguiente comando para recuperar la definición del modelo de activos activa:

      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. Para obtener más información, consulte la operación DescribeAssetModelCompositeModel.

  2. Cree un archivo llamado update-custom-composite-model.json y, a continuación, copie la respuesta del comando anterior en el archivo.

  3. Elimine todos los pares de clave-valor del objeto JSON en update-custom-composite-model.json, salvo los campos siguientes:

    • assetModelCompositeModelName

    • assetModelCompositeModelDescription (si está presente)

    • assetModelCompositeModelProperties (si está presente)

  4. En update-custom-composite-model.json, realice una de las siguientes acciones:

    • Cambie el valor de assetModelCompositeModelName.

    • Añada o elimine assetModelCompositeModelDescription, o cambie su valor.

    • Solo para modelos compuestos personalizados en línea: cambie, añada o elimine cualquiera de las propiedades del modelo de activos en assetModelCompositeModelProperties.

    Para obtener más información sobre el formato necesario para este archivo, consulte la sintaxis de la solicitud UpdateAssetModelCompositeModel.

  5. Ejecute el siguiente comando para actualizar el modelo compuesto personalizado con la definición almacenada en update-custom-composite-model.json. composite-model-idSustitúyalo por el ID del modelo compuesto y asset-model-id por el ID del modelo de activos en el que se encuentra.

    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

Cuando varios usuarios actualizan un modelo de activos al mismo tiempo, es posible que un usuario sobrescriba sin darse cuenta los cambios de otro usuario. Para evitarlo, debe definir una solicitud de actualización condicional. Consulte Bloqueo positivo de las escrituras del modelo de activos.