Estados de ativos e modelos

Quando você cria, atualiza ou exclui um ativo, um modelo de ativo ou um modelo de componente, as alterações demoram para se propagar. AWS IoT SiteWise resolve essas operações de forma assíncrona e atualiza o status de cada recurso. Cada ativo, modelo de ativo e modelo de componente tem um campo de status que contém o estado do recurso e qualquer mensagem de erro, se aplicável. O estado pode ser um dos seguintes valores:

• ACTIVE— O recurso está ativo. Esse é o único estado em que você pode consultar e interagir com ativos, modelos de ativos e modelos de componentes.

• CREATING— O recurso está sendo criado.

• UPDATING— O recurso está sendo atualizado.

• DELETING— O recurso está sendo excluído.

• PROPAGATING— (Somente modelos de ativos e modelos de componentes) As mudanças estão se propagando para todos os recursos dependentes (do modelo do ativo para os ativos ou do modelo do componente para os modelos do ativo).

• FAILED— O recurso falhou na validação durante uma operação de criação ou atualização, possivelmente devido a uma referência circular em uma expressão. Você pode excluir recursos que estão no FAILED estado.

Algumas das operações de criação, atualização e exclusão AWS IoT SiteWise ACTIVE implementam um ativo, modelo de ativo ou modelo de componente em um estado diferente do estado em que a operação é resolvida. Para consultar ou interagir com um recurso depois de realizar uma dessas operações, você deve esperar até que o estado mude paraACTIVE. Caso contrário, suas solicitações falharão.

Verificar o status de um ativo

Você pode usar o AWS IoT SiteWise console ou a API para verificar o status de um ativo.

Tópicos

• Verificar o status de um ativo (console)
• Verificando o status de um ativo (AWS CLI)

Verificar o status de um ativo (console)

Use o procedimento a seguir para verificar o status de um ativo no console do AWS IoT SiteWise .

Como verificar o status de um ativo (console)

1. Navegue até o console do AWS IoT SiteWise.

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

3. Escolha o ativo a ser verificado.

   dica

   Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

4. Localize Status no painel Detalhes do ativo .

   

Verificando o status de um ativo (AWS CLI)

Você pode usar o AWS Command Line Interface (AWS CLI) para verificar o status de um ativo.

Para verificar o status de um ativo, use a DescribeAssetoperação com o assetId parâmetro.

Para verificar o status de um ativo (AWS CLI)

• Execute o comando a seguir para descrever o ativo. Substitua asset-id pelo ID do ativo ou ID externo. A ID externa é uma ID definida pelo usuário. Para obter mais informações, consulte Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .

  aws iotsitewise describe-asset --asset-id asset-id

  A operação retorna uma resposta que contém os detalhes do ativo. A resposta contém um assetStatus objeto que tem a seguinte estrutura:

  {
      ...
      "assetStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  O estado do ativo está em assetStatus.state no objeto JSON.

Verificando o status de um modelo de ativo ou modelo de componente

Você pode usar o AWS IoT SiteWise console ou a API para verificar o status de um modelo de ativo ou modelo de componente.

Tópicos

• Verificando o status de um modelo de ativo ou modelo de componente (console)
• Verificando o status de um modelo de ativo ou modelo de componente (AWS CLI)

Verificando o status de um modelo de ativo ou modelo de componente (console)

Use o procedimento a seguir para verificar o status 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 verificar o status 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 a ser verificado.

4. Localize Status no painel Detalhes.

   

Verificando o status de um modelo de ativo ou modelo de componente (AWS CLI)

Você pode usar o AWS CLI para verificar o status de um modelo de ativo ou modelo de componente.

Para verificar o status de um modelo de ativo ou modelo de componente, use a operação DescribeAssetModelo com o assetModelId parâmetro.

dica

O AWS CLI define modelos de componentes como um tipo de modelo de ativo. Portanto, você usa a mesma operação de DescribeAssetmodelo para os dois tipos de modelo. O assetModelType campo na resposta indica se é um ASSET_MODEL ou umCOMPONENT_MODEL.

Para verificar o status de um modelo de ativo ou modelo de componente (AWS CLI)

• Execute o comando a seguir para descrever o modelo. Substitua asset-model-id pelo ID ou pelo 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 Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .

  aws iotsitewise describe-asset-model --asset-model-id asset-model-id

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

  {
      ...
      "assetModelStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  O estado do modelo está assetModelStatus.state no objeto JSON.