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

# Associar e desassociar ativos
<a name="add-associated-assets"></a>

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 [Definir hierarquias de modelos de ativo](define-asset-hierarchies.md). Se você estiver usando interfaces, as hierarquias definidas na interface serão aplicadas nos modelos de ativos que implementam a interface. Para obter mais informações sobre interfaces, consulte[Interfaces de modelos de ativos](model-interfaces.md).

**Topics**
+ [Associar e desassociar ativos (console)](#associate-asset-console)
+ [Associar e desassociar ativos (AWS CLI)](#associate-asset-cli)

## Associar e desassociar ativos (console)
<a name="associate-asset-console"></a>

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

**Como associar um ativo (console)**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>No painel de navegação, selecione **Ativos**.

1. Escolha o ativo pai ao qual deseja associar um ativo filho.
**dica**  <a name="sitewise-expand-asset-hierarchy"></a>
Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

1. Escolha **Editar**.

1. Em **Ativos associados a este ativo**, escolha **Adicionar ativo associado**.  
![\[A página AWS IoT SiteWise Editar ativo com este texto de campo: Adicionar ativo associado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/sitewise-associate-asset-console.png)

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

1. Em **Ativo**, escolha o ativo filho a ser associado.

1. Escolha **Salvar**.

**Como desassociar um ativo (console)**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>No painel de navegação, selecione **Ativos**.

1. Escolha o ativo pai do qual deseja desassociar um ativo filho.
**dica**  <a name="sitewise-expand-asset-hierarchy"></a>
Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

1. Escolha **Editar**.

1. Em **Ativos associados a este ativo**, escolha **Desassociar** para o ativo.  
![\[AWS IoT SiteWise Captura de tela da página “Editar ativo” com “Desassociar” destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/sitewise-disassociate-asset-console.png)

1. Escolha **Salvar**.

## Associar e desassociar ativos (AWS CLI)
<a name="associate-asset-cli"></a>

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

Para este procedimento, você deve saber a ID da hierarquia (`hierarchyId`) no modelo do ativo pai que define o relacionamento com o modelo do ativo filho. Use a [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operaçã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-id*Substitua pela ID do ativo principal ou pela ID externa.

  ```
  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"
      }
    ],
    ...
  }
  ```

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

Depois de obter a ID da hierarquia, associe ou desassocie um ativo com essa hierarquia.

Para associar um ativo secundário a um ativo principal, use a [AssociateAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateAssets.html)operação. Para desassociar um ativo secundário de um ativo principal, use a [DisassociateAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DisassociateAssets.html)operação. Especifique os seguintes parâmetros, que são os mesmos para as duas operações:
+ `assetId`: o ID ou o ID externo do ativo pai.
+ `hierarchyId`: o ID ou o ID externo da hierarquia no ativo pai.
+ `childAssetId`: o ID ou o ID externo do ativo filho.

**Como associar um ativo (AWS CLI)**
+ Execute o seguinte comando para associar um ativo filho a um ativo pai. Substitua *parent-asset-id**hierarchy-id*,, e *child-asset-id* pelo respectivo IDs:

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

**Como desassociar um ativo (AWS CLI)**
+ Execute o seguinte comando para desassociar um ativo filho de um ativo pai. Substitua *parent-asset-id**hierarchy-id*,, e *child-asset-id* pelo respectivo IDs:

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