Versões do modelo de ativo - AWS IoT SiteWise
Recuperar a versão ativa de um modelo de ativo ou modelo de componente (console)Recuperar 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 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.

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

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.

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

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-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 Objetos de referência com objetos externos IDs 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"
}