Associar e desassociar ativos

Se o modelo do ativo definir quaisquer hierarquias de modelo de ativo filho, você poderá associar ativos filho ao ativo. Os ativos pai podem acessar e agregar dados de ativos associados. Para obter mais informações sobre modelos de ativos de hierarquia, consulte Definindo relacionamentos entre modelos de ativos (hierarquias).

Associar e desassociar ativos (console)

Você pode usar o console do AWS IoT SiteWise para associar e desassociar ativos.

Como associar um ativo (console)

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

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

3. Escolha o ativo pai ao qual deseja associar um ativo filho.

   dica

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

   

4. Escolha Edit (Editar).

5. Em Ativos associados a este ativo, escolha Adicionar ativo associado.

   

6. Em Hierarquia, escolha a hierarquia que define o relacionamento entre o ativo pai e o ativo filho.

7. Em Ativo, escolha o ativo filho a ser associado.

8. Escolha Save (Salvar).

Como desassociar um ativo (console)

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

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

3. Escolha o ativo pai do qual deseja desassociar um ativo filho.

   dica

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

   

4. Escolha Edit (Editar).

5. Em Ativos associados a este ativo, escolha Desassociar para o ativo.

   

6. Escolha Save (Salvar).

Associar e desassociar ativos (CLI)

Você pode usar a AWS Command Line Interface (AWS CLI) para associar e desassociar ativos.

Para este procedimento, você deve saber o ID da hierarquia (hierarchyId) no modelo do ativo pai que define o relacionamento com o modelo do ativo filho. Use a DescribeAssetoperação para encontrar o ID da hierarquia na resposta.

Como localizar um ID de hierarquia

• Execute o seguinte comando para descrever o ativo pai. parent-asset-idSubstitua pelo ID do ativo principal.

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

  A operação retorna uma resposta que contém os detalhes do ativo. A resposta contém uma lista de assetHierarchies que tem a seguinte estrutura.

  {
    ... 
    "assetHierarchies": [
      {
        "id": "String",
        "name": "String"
      }
    ],
    ...
  }

  O ID da hierarquia é o valor de id de uma hierarquia na lista de hierarquias de ativos.

Depois de ter o ID da hierarquia, associe ou desassocie um ativo com essa hierarquia.

Para associar um ativo filho a um ativo pai, use a AssociateAssetsoperação. Para desassociar um ativo filho de um ativo pai, use a DisassociateAssetsoperação. Especifique os seguintes parâmetros, que são os mesmos para as duas operações:

• assetId— O ID do ativo principal.

• hierarchyId— O ID da hierarquia no ativo principal.

• childAssetId— O ID do ativo infantil.

Como associar um ativo (CLI)

• Execute o seguinte comando para associar um ativo filho a um ativo pai. Substitua parent-asset-id, hierarchy-id e child-asset-idpelos respectivos IDs.

  aws iotsitewise associate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id

Como desassociar um ativo (CLI)

• Execute o seguinte comando para desassociar um ativo filho de um ativo pai. Substitua parent-asset-id, hierarchy-id e child-asset-idpelos respectivos IDs.

  aws iotsitewise disassociate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id