Actualice los modelos compuestos personalizados (componentes) - AWS IoT SiteWise
Actualizar un componente (consola)Actualice 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.

Actualice los 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.

Actualizar un componente (consola)

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

Para actualizar 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 activo en el que se encuentra el componente.

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

  5. Elija el componente que desee actualizar.

  6. Elija Editar.

  7. En la página Editar componente, realice una de las siguientes acciones:

  8. Seleccione Guardar.

Actualice 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, ya que 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 puede cambiar el tipo o el tipo de datos de una propiedad existente.

Para reemplazar una propiedad de modelo compuesto existente por una nueva con la misma propiedadname, haga lo siguiente:

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

  2. Envía una segunda UpdateAssetModelCompositeModel solicitud que incluya la nueva propiedad. El nuevo activo será el name mismo que el anterior y AWS IoT SiteWise generará un nuevo activo únicoid.

Para actualizar un modelo compuesto personalizado (AWS CLI)

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

    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 un FAILED estado, recupere la definición de modelo válida correspondiente a su versión activa para crear su solicitud de actualización. Para obtener más información, consulte Versiones del modelo de activos.

    3. Ejecute el siguiente comando para recuperar la definición del modelo activo:

      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 DescribeAssetModelCompositeModeloperación.

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

  3. Elimine todos los pares clave-valor del JSON objetoupdate-custom-composite-model.json, excepto 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 deassetModelCompositeModelName.

    • AñadaassetModelCompositeModelDescription, elimine 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 enassetModelCompositeModelProperties.

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

  5. Ejecute el siguiente comando para actualizar el modelo compuesto personalizado con la definición almacenada enupdate-custom-composite-model.json. Reemplazar composite-model-id con el ID del modelo compuesto, y asset-model-id con el ID del modelo de activo 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 otro usuario sobrescriba inadvertidamente los cambios de un usuario. Para evitarlo, debe definir una solicitud de actualización condicional. Consulte El bloqueo optimista de las escrituras del modelo de activos.