Actualice los modelos de activos y los modelos de componentes - AWS IoT SiteWise
Actualización de un modelo de activo o componente (consola)Actualizar un modelo de activo o componente ()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 de activos y los modelos de componentes

Utilice la AWS IoT SiteWise consola o API actualice un modelo de activos o un modelo de componentes.

No puede cambiar el tipo o el tipo de datos de una propiedad existente ni la ventana de una métrica existente. Tampoco puede cambiar el tipo de modelo de un modelo de activos a un modelo de componentes o al revés.

importante

  • Si elimina una propiedad de un modelo de activos o de un modelo de componentes, AWS IoT SiteWise elimina todos los datos anteriores de esa propiedad. En el caso de los modelos de componentes, esto afecta a todos los modelos de activos que utilizan ese modelo de componentes, por lo que debe tener especial cuidado de comprender hasta qué punto puede aplicarse el cambio.

  • Si elimina una definición de jerarquía de un modelo de activos, AWS IoT SiteWise disocia todos los activos de esa jerarquía.

Al actualizar un modelo de activos, todos los activos basados en ese modelo reflejan los cambios que realice en el modelo subyacente. Hasta que los cambios se propaguen, cada activo tiene el estado UPDATING. Debe esperar hasta que esos activos vuelvan al estado ACTIVE antes de interactuar con ellos. Durante este tiempo, el estado del modelo de activos actualizado será PROPAGATING.

Al actualizar un modelo de componentes, todos los modelos de activos que incorporan ese modelo de componentes reflejan los cambios. Hasta que los cambios en el modelo de componentes se propaguen, cada modelo de activo afectado tiene el UPDATING estado y, a continuación, sus activos asociados, tal y como se describe en el párrafo anterior. PROPAGATING Debe esperar a que esos modelos de activos vuelvan a su ACTIVE estado antes de interactuar con ellos. Durante este tiempo, el estado del modelo de componentes actualizado seráPROPAGATING.

Para obtener más información, consulte Estados de activos y modelos.

Actualización de un modelo de activo o componente (consola)

Puede utilizar la AWS IoT SiteWise consola para actualizar un modelo de activos o un modelo de componentes.

Para actualizar un modelo de activos o un modelo de componentes (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 o el modelo de componentes que desee actualizar.

  4. Elija Editar.

  5. En la página Editar el modelo, realice alguna de las siguientes acciones:

  6. Seleccione Guardar.

nota

Las solicitudes de actualización realizadas en la consola se rechazan si otro usuario actualiza correctamente el modelo de activos desde la última vez que abriste la página de edición del modelo. La consola solicita al usuario que actualice la página de edición del modelo para obtener el modelo actualizado. Debe volver a realizar las actualizaciones y volver a intentar guardarlas. Consulte El bloqueo optimista de las escrituras del modelo de activos para obtener más detalles.

Actualizar un modelo de activo o componente ()AWS CLI

Utilice AWS Command Line Interface (AWS CLI) para actualizar un modelo de activos o un modelo de componentes.

Utilice el UpdateAssetModelAPIpara actualizar el nombre, la descripción y las propiedades de un modelo de activos o un modelo de componentes. Solo para los modelos de activos, puede actualizar las jerarquías. Especifique los siguientes parámetros:

Especifique el modelo actualizado en la carga útil. Para obtener información sobre el formato esperado de un modelo de activos o un modelo de componentes, consulteCree modelos de activos.

aviso

UpdateAssetModelAPISobrescribe el modelo existente con el modelo que usted proporciona en la carga útil. Para evitar eliminar las propiedades o jerarquías del modelo, debe incluir sus propiedades IDs y sus definiciones en la carga útil del modelo actualizado. Para obtener información sobre cómo consultar la estructura existente del modelo, consulte la DescribeAssetModeloperación.

nota

El siguiente procedimiento solo puede actualizar modelos compuestos de este tipoAWS/ALARM. Si desea actualizar los modelos CUSTOM compuestos, utilice UpdateAssetModelCompositeModelen su lugar. Para obtener más información, consulte Actualice los modelos compuestos personalizados (componentes).

Para actualizar un modelo de activos o un modelo de componentes (AWS CLI)

  1. Ejecute el siguiente comando para recuperar la definición del modelo existente. Reemplazar asset-model-id con el ID o el ID externo del modelo de activos o del modelo de componentes que se va a actualizar.

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id

    El comando anterior devuelve la definición del modelo correspondiente a la última versión del modelo.

    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. Ejecute el siguiente comando para recuperar la definición del modelo activo:

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    La operación devuelve una respuesta que contiene los detalles del modelo. La respuesta tiene la siguiente estructura.

    {
    "assetModelId": "String",
    "assetModelArn": "String",
    "assetModelName": "String",
    "assetModelDescription": "String",
    "assetModelProperties": Array of AssetModelProperty,
    "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
    "assetModelCompositeModels": Array of AssetModelCompositeModel,
    "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary,
    "assetModelCreationDate": "String",
    "assetModelLastUpdateDate": "String",
    "assetModelStatus": {
      "state": "String",
      "error": {
        "code": "String",
        "message": "String"
      },
    "assetModelType": "String"
    },
    "assetModelVersion": "String",
    "eTag": "String"
}

    Para obtener más información, consulte la DescribeAssetModeloperación.

  2. Cree un archivo llamado update-asset-model.json y copie la respuesta del comando anterior en el archivo.

  3. Elimine los siguientes pares clave-valor del JSON objeto en: update-asset-model.json

    • assetModelId

    • assetModelArn

    • assetModelCompositeModelSummaries

    • assetModelCreationDate

    • assetModelLastUpdateDate

    • assetModelStatus

    • assetModelType

    • assetModelVersion

    • eTag

    La UpdateAssetModeloperación espera una carga útil con la siguiente estructura:

    {
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
  "assetModelCompositeModels": Array of AssetModelCompositeModel
}

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

    • Cambie el nombre del modelo de activos (assetModelName).

    • Cambie, agregue o elimine la descripción del modelo de activos (assetModelDescription).

    • Cambie, agregue o elimine cualquiera de las propiedades del modelo de activos (assetModelProperties). No puede cambiar dataType de las propiedades existentes ni window de las métricas existentes. Para obtener más información, consulte Defina las propiedades de los datos.

    • Cambie, agregue o elimine cualquiera de las jerarquías del modelo de activos (assetModelHierarchies). No puede cambiar childAssetModelId de las jerarquías existentes. Para obtener más información, consulte Defina las jerarquías del modelo de activos.

    • Cambie, añada o elimine cualquiera de los modelos compuestos de tipo AWS/ALARM (assetModelCompositeModels) del modelo de activos. Las alarmas monitorean otras propiedades para que pueda identificar cuándo requieren atención los equipos o procesos. Cada definición de alarma es un modelo compuesto que estandariza el conjunto de propiedades que utiliza la alarma. Para obtener más información, consulte Supervise los datos con alarmas y Defina las alarmas en los modelos de activos.

  5. Ejecute el siguiente comando para actualizar el modelo de activos con la definición almacenada en update-asset-model.json. Reemplazar asset-model-id con el ID del modelo de activos:

    aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://model-payload.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.