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)
<a name="update-custom-composite-models"></a>

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

**Topics**
+ [Actualización de un componente (consola)](#update-custom-composite-model-console)
+ [Actualización de un modelo compuesto personalizado (AWS CLI)](#update-custom-composite-model-cli)

## Actualización de un componente (consola)
<a name="update-custom-composite-model-console"></a>

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

**Actualización de un componente (consola)**

1. <a name="sitewise-open-console"></a>Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>En el panel de navegación, elija **Models (Modelos)**.

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

1. En la pestaña **Propiedades**, elija **Componentes**.

1. Elija el componente que desea actualizar.

1. Elija **Edit (Edición de)**.

1. En la página **Editar componente**, lleve a cabo alguna de las siguientes operaciones:
   + En **Detalles del modelo**, cambie el **Nombre** del modelo.
   + Cambie cualquiera de las **Definiciones de atributos**. No se puede cambiar el **Tipo de datos** de los atributos existentes. Para obtener más información, consulte [Definición de datos estáticos (atributos)](attributes.md).
   + Cambie cualquiera de las **Definiciones de mediciones**. No se puede cambiar el **Tipo de datos** de las mediciones existentes. Para obtener más información, consulte [Definición de flujos de datos procedentes del equipo (mediciones)](measurements.md).
   + Cambie cualquiera de las **Definiciones de transformación**. Para obtener más información, consulte [Datos de transformación (transformaciones)](transforms.md).
   + Cambie cualquiera de las **Definiciones de métricas**. No se puede cambiar el **Intervalo de tiempo** de las métricas existentes. Para obtener más información, consulte [Agregación de datos desde propiedades y otros activos (métricas)](metrics.md).

1. Seleccione **Save**.

## Actualización de un modelo compuesto personalizado (AWS CLI)
<a name="update-custom-composite-model-cli"></a>

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

Para actualizar el nombre o la descripción, utilice la [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)operació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 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:  
Envíe una solicitud `UpdateAssetModelCompositeModel` con toda la propiedad existente eliminada.
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 única`id`.

**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-id*Sustitú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
      ```

   1.  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](model-active-version.md). 

   1. 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
      ```

   1. Para obtener más información, consulte la operación [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html).

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

1. 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)

1. 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](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html).

1. Ejecute el siguiente comando para actualizar el modelo compuesto personalizado con la definición almacenada en `update-custom-composite-model.json`. *composite-model-id*Sustitú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](opt-locking-for-model.md).