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 SiteWisesuporta 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 SiteWisepropaga 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 são retornados quando as APIs de descrição são chamadas 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 SiteWiseExiste 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)
+ [Recupere 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**. 

## Recupere 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`. 

**Para 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 [Fazer referência a objetos com IDs externos](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}}"
  }
  ```