As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Versões do modelo de ativo
<a name="model-active-version"></a>

 AWS IoT SiteWise suporta o processamento assíncrono de operações de criação e atualização em modelos de ativos e modelos de componentes. Ele também atualiza o status do modelo. 

 AWS IoT SiteWise propaga as alterações de um modelo válido nas solicitações de criação e atualização para seus recursos dependentes (do modelo do ativo para os ativos ou do modelo do componente para os modelos do ativo). Depois, ele coloca o modelo no estado `ACTIVE`. 

 Se a definição do modelo fornecida for inválida, AWS IoT SiteWise coloca o modelo em um `FAILED` estado. As alterações não serão propagadas para os recursos dependentes. Os recursos dependentes consultam a definição de modelo mais recente propagada quando o modelo estava em um estado `ACTIVE`. 

 Com base nas informações acima, as definições de modelo têm dois tipos de versões de modelo: 

1. **Versão mais recente**: a definição mais recente aceita como parte de uma solicitação de criação ou atualização.

1. **Versão ativa**: a definição mais recente processada com êxito, e o estado do modelo é `ACTIVE`.

 Por padrão, os detalhes da versão mais recente do modelo APIs são retornados quando a descrição é chamada em um modelo de ativo ou modelo de componente. Há cenários em que a versão ativa do modelo de ativo ou do modelo de componente é necessária. Veja alguns exemplos de cenários abaixo: 
+  Uma operação de atualização com uma definição inválida coloca o modelo de ativo em um estado `FAILED`. Você deve reverter as alterações, recuperando a versão ativa do modelo de ativo e criando outra solicitação de atualização que faça referência a essa definição válida. 
+  AWS IoT SiteWise Existe um aplicativo no qual os clientes podem visualizar os ativos e seus modelos de ativos correspondentes. Quando um usuário consulta a definição do modelo de ativo correspondente a um ativo específico e o modelo de ativo está em um estado transitório `UPDATING`, `PROPAGATING` ou `FAILED`, a versão mais recente retorna a definição do modelo de ativo que ainda não foi propagada para os ativos. Nesse caso, você deve recuperar a versão ativa do modelo de ativo para os clientes. 

**Topics**
+ [Recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)](#active-console)
+ [Recuperar a versão ativa de um modelo de ativo ou modelo de componente (AWS CLI)](#active-cli)

## Recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)
<a name="active-console"></a>

Siga este procedimento para recuperar a versão ativa de um modelo de ativo ou modelo de componente no AWS IoT SiteWise console.

**dica**  
Os modelos de ativo e os modelos de componente estão listados em **Modelos** no painel de navegação. O painel **Detalhes** do modelo de ativo ou do modelo de componente selecionado indica de que tipo ele é.

**Como recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>No painel de navegação, selecione **Modelos**.

1. Escolha o modelo para recuperar a versão ativa dele.

   1.  Se o modelo estiver em um estado `ACTIVE`, você já estará vendo a versão ativa. 

   1.  Se o modelo estiver em um estado transitório `UPDATING`, `PROPAGATING` ou `FAILED`, encontre a opção **Ver versão ativa** em **Status** no painel **Detalhes**. 

## Recuperar a versão ativa de um modelo de ativo ou modelo de componente (AWS CLI)
<a name="active-cli"></a>

Use o AWS CLI para recuperar a versão ativa de um modelo de ativo ou modelo de componente.

Para recuperar a versão ativa de um modelo de ativo ou modelo de componente, use a [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operação com o `assetModelVersion` parâmetro.

**dica**  
O AWS CLI define modelos de componentes como um tipo de modelo de ativo. Portanto, você usa a mesma [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operação para os dois tipos de modelo. O campo `assetModelType` na resposta indica se é um `ASSET_MODEL` ou um `COMPONENT_MODEL`. 

**Como recuperar a versão ativa de um modelo de ativo ou modelo de componente (AWS CLI)**
+ Execute o comando a seguir para descrever o modelo. *asset-model-id*Substitua pela ID ou pela ID externa do modelo do ativo ou do modelo do componente. O ID externo é um ID definido pelo usuário. Consulte mais informações em [Objetos de referência com objetos externos IDs](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *.

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

  A operação retorna uma resposta com os detalhes do modelo. A resposta contém um objeto `assetModelStatus` com a estrutura a seguir.

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