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.

# Versiones de modelos de activos
<a name="model-active-version"></a>

 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 estado `ACTIVE`. 

 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 hacen referencia a la última definición del modelo propagada cuando el modelo estaba en estado `ACTIVE`. 

 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.

1. **Versión activa:** la definición más reciente procesada correctamente y el estado del modelo es `ACTIVE`.

 De forma predeterminada, los detalles de la última versión del modelo se muestran cuando APIs se solicita la descripción 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 escenarios de ejemplo a continuación: 
+  Una operación de actualización con una definición no válida coloca el modelo de activos en estado `FAILED`. 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 hace referencia a la definición del modelo de activos correspondiente a un activo concreto y el modelo de activos se encuentra en estado `UPDATING`, `PROPAGATING` o `FAILED` transitorio, la versión más reciente devuelve la definición del modelo de activos que aún no se ha propagado a sus activos. En este caso, debe recuperar la versión activa del modelo de activos a los clientes. 

**Topics**
+ [Recupere la versión activa de un modelo de activos o un modelo de componentes (consola).](#active-console)
+ [Recupere la versión activa de un modelo de activos o un modelo de componentes (AWS CLI).](#active-cli)

## Recupere la versión activa de un modelo de activos o un modelo de componentes (consola).
<a name="active-console"></a>

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

**sugerencia**  
Tanto los modelos de activos como los modelos de componentes se muestran en **Modelos** en el panel de navegación. El panel **Detalles** del modelo de activos o del modelo de componentes seleccionado indica de qué tipo se trata.

**Recuperación de la versión activa de un modelo de activos o un modelo de componentes (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 para el que desea recuperar su versión activa.

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

   1.  Si el modelo se encuentra en estado `UPDATING`, `PROPAGATING` o `FAILED` transitorio, busque la opción **Ver la versión activa** en **Estado** en el panel **Detalles**. 

## Recupere la versión activa de un modelo de activos o un modelo de componentes (AWS CLI).
<a name="active-cli"></a>

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 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operació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 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operación para ambos tipos de modelo. El campo `assetModelType` de la respuesta indica si es un `ASSET_MODEL` o un `COMPONENT_MODEL`. 

**Recuperación de la versión activa de un modelo de activos o un modelo de componentes (AWS CLI)**
+ Ejecute el siguiente comando para describir el modelo. {{asset-model-id}}Sustitúyalo por 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 [Objetos de referencia con objetos externos IDs](object-ids.md#external-id-references) 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 objeto `assetModelStatus` con la siguiente estructura.

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