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.

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:

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

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

   • Cambie cualquiera de las Definiciones de transformación. Para obtener más información, consulte Transformación de datos (transformaciones).

   • 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 de propiedades y otros activos (métricas).

8. Seleccione Save (Guardar).

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

Puede utilizar 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. composite-model-idSustitúyalo por el ID o el ID externo del modelo compuesto personalizado que se va a actualizar y asset-model-idpor el modelo de activos al que está asociado el modelo compuesto personalizado. Para obtener más información, consulte AWS IoT SiteWise en la Guía del usuario de .

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

   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 objeto JSONupdate-custom-composite-model.json, excepto los siguientes campos:

   • 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. composite-model-idSustitúyalo por el ID del modelo compuesto y asset-model-idpor 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