Versiones del modelo de activos

AWS IoT SiteWise admite el procesamiento asíncrono de las operaciones de creación y actualización de modelos de activos y modelos de componentes. También actualiza el estado del modelo.

AWS IoT SiteWise propaga los cambios de un modelo válido en las solicitudes de creación y actualización a sus recursos dependientes (del modelo de activos a los activos o del modelo de componentes a los modelos de activos). A continuación, coloca el modelo en ACTIVE estado.

Si la definición del modelo proporcionada no es válida, AWS IoT SiteWise coloca el modelo en un FAILED estado. Los cambios no se propagan a los recursos dependientes. Los recursos dependientes se refieren a la última definición del modelo propagada cuando el modelo estaba en un ACTIVE estado.

Según la información anterior, las definiciones de modelos tienen dos tipos de versiones de modelos:

1. Última versión: la definición más reciente aceptada como parte de una solicitud de creación o actualización.

2. Versión activa: la última definición se procesó correctamente y el estado del modelo esACTIVE.

De forma predeterminada, los detalles de la última versión del modelo se muestran cuando se invoca la descripción APIs en un modelo de activos o un modelo de componentes. Hay escenarios en los que se necesita la versión activa del modelo de activos o del modelo de componentes. Consulte los escenarios de ejemplo que aparecen a continuación:

• Una operación de actualización con una definición no válida coloca el modelo de activos en un FAILED estado. Debe revertir los cambios recuperando la versión activa del modelo de activos y creando otra solicitud de actualización que haga referencia a esta definición válida.

• AWS IoT SiteWise Existe una aplicación en la que los clientes pueden ver los activos y sus modelos de activos correspondientes. Cuando un usuario consulta la definición del modelo de activos correspondiente a un activo concreto y el modelo de activo se encuentra en un FAILED estado transitorio o transitorio UPDATINGPROPAGATING, la última versión devuelve la definición del modelo de activo que aún no se ha propagado a sus activos. En este caso, debe recuperar la versión activa del modelo de activos entre los clientes.

Recupere la versión activa de un modelo de activos o un modelo de componentes (consola)

Siga este procedimiento para recuperar la versión activa de un modelo de activos o de componentes en la AWS IoT SiteWise consola.

sugerencia

Tanto los modelos de activos como los modelos de componentes se muestran en la sección Modelos del panel de navegación. El panel de detalles del modelo de activo o modelo de componente seleccionado indica de qué tipo se trata.

Para recuperar la versión activa de 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 para recuperar su versión activa.

   1. Si el modelo está en un ACTIVE estado, está viendo su versión activa.

   2. Si el modelo se encuentra en un FAILED estado transitorio UPDATING o transitorio, busque la opción Ver versión activa en Estado en el panel de detalles. PROPAGATING

Recupere la versión activa de un modelo de activos o un modelo de componentes ()AWS CLI

Utilice el AWS CLI para recuperar la versión activa de un modelo de activos o un modelo de componentes.

Para recuperar la versión activa de un modelo de activos o un modelo de componentes, utilice la DescribeAssetModeloperación con el assetModelVersion parámetro.

sugerencia

AWS CLI Define los modelos de componentes como un tipo de modelo de activos. Por lo tanto, se utiliza la misma DescribeAssetModeloperación para ambos tipos de modelo. El assetModelType campo de la respuesta indica si es un ASSET_MODEL o unCOMPONENT_MODEL.

Para recuperar la versión activa de un modelo de activos o un modelo de componentes (AWS CLI)

• Ejecute el siguiente comando para describir el modelo. Reemplazar asset-model-id con el ID o el ID externo del modelo de activos o del modelo de componentes. El ID externo es un ID definido por el usuario. Para obtener más información, consulte Haga referencia a objetos con objetos externos IDs en la Guía del usuario de AWS IoT SiteWise .

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

  La operación devuelve una respuesta con los detalles del modelo. La respuesta contiene un assetModelStatus objeto con la siguiente estructura.

  {
      ...
      "assetModelName": "string",
      "assetModelProperties": [ ... ],
      ...,
      "assetModelVersion": "string"
  }