Versões do modelo de ativos - AWS IoT SiteWise
Recupere 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 ativos

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). Em seguida, ele coloca o modelo no ACTIVE estado.

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 são propagadas para os recursos dependentes. Os recursos dependentes se referem à última definição de modelo propagada quando o modelo estava em um ACTIVE estado.

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 foi processada com sucesso 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 ativos ou do modelo de componentes é necessária. Veja exemplos de cenários abaixo:

  • Uma operação de atualização com uma definição inválida coloca seu modelo de ativo em um FAILED estado. Você deve reverter suas alterações recuperando a versão ativa do modelo de ativo e criando outra solicitação de atualização referente 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 refere a definição do modelo de ativo correspondente a um ativo específico e o modelo de ativo está em um FAILED estado transitório ou transitório UPDATINGPROPAGATING, a versão mais recente retorna a definição do modelo de ativo que ainda não foi propagada para seus ativos. Nesse caso, você deve recuperar a versão ativa do modelo de ativo para os clientes.

Recupere 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 ativos e os modelos de componentes estão listados em Modelos no painel de navegação. O painel Detalhes do modelo de ativo ou modelo de componente selecionado indica de que tipo ele é.

Para 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 sua versão ativa.

    1. Se o modelo estiver em um ACTIVE estado, você estará visualizando sua versão ativa.

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

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 assetModelType campo na resposta indica se é um ASSET_MODEL ou umCOMPONENT_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. Substituir asset-model-id com o ID ou o ID externo do modelo do ativo ou do modelo do componente. A ID externa é uma ID definida pelo usuário. Para obter mais informações, consulte 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 assetModelStatus objeto com a estrutura a seguir.

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