View a markdown version of this page

Versões do modelo de ativo - AWS IoT SiteWise
Recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)Recupere a versão ativa de um modelo de ativo ou modelo de componente (AWS CLI)

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

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.

  2. 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.

Recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)

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. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, selecione Modelos.

  3. 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.

    2. 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)

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 DescribeAssetModeloperaçã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 DescribeAssetModeloperaçã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-idSubstitua 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 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"
}