

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Asociación y desasociación de activos
<a name="add-associated-assets"></a>

Si el modelo de activos define jerarquías de modelos de activos secundarios, puede asociar activos secundarios al activo. Los activos principales pueden acceder a los datos de los activos asociados y agregarlos. Para obtener más información acerca de los modelos de activos jerárquicos, consulte [Definición de jerarquías de modelos de activos](define-asset-hierarchies.md). Si utiliza interfaces, las jerarquías definidas en la interfaz se aplican a los modelos de activos que implementan la interfaz. Para obtener más información sobre las interfaces, consulte[Interfaces del modelo de activos](model-interfaces.md).

**Topics**
+ [Asociación y desasociación de activos (consola)](#associate-asset-console)
+ [Asociación y desasociación de activos (AWS CLI)](#associate-asset-cli)

## Asociación y desasociación de activos (consola)
<a name="associate-asset-console"></a>

Puede utilizar la AWS IoT SiteWise consola para asociar y desasociar activos.

**Para asociar un activo (consola)**

1. <a name="sitewise-open-console"></a>Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>En el panel de navegación, elija **Activos**.

1. Elija el activo principal con el que desea asociar un activo secundario.
**sugerencia**  <a name="sitewise-expand-asset-hierarchy"></a>
Puede elegir el icono de flecha para expandir una jerarquía de activos y encontrar su activo.

1. Elija **Edit (Edición de)**.

1. En **Activos asociados a este activo**, elija **Agregar un activo asociado**.  
![La página de AWS IoT SiteWise edición de activos con este texto de campo: Añadir activo asociado.](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/images/sitewise-associate-asset-console.png)

1. En **Jerarquía**, elija la jerarquía que defina la relación entre el activo principal y el activo secundario.

1. En **Activo**, elija el activo secundario que desea asociar.

1. Seleccione **Save**.

**Para disociar un activo (consola)**

1. <a name="sitewise-open-console"></a>Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>En el panel de navegación, elija **Activos**.

1. Elija el activo principal para el que desea disociar un activo secundario.
**sugerencia**  <a name="sitewise-expand-asset-hierarchy"></a>
Puede elegir el icono de flecha para expandir una jerarquía de activos y encontrar su activo.

1. Elija **Edit (Edición de)**.

1. En **Activos asociados a este activo**, elija **Desvincular** para el activo.  
![AWS IoT SiteWise Captura de pantalla de la página «Editar activo» con la palabra «Desasociar» resaltada.](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/images/sitewise-disassociate-asset-console.png)

1. Seleccione **Save**.

## Asociación y desasociación de activos (AWS CLI)
<a name="associate-asset-cli"></a>

Puede usar AWS Command Line Interface (AWS CLI) para asociar y desasociar activos.

Para este procedimiento, debe conocer el ID de la jerarquía (`hierarchyId`) en el modelo de activos principal que define la relación con el modelo de activos secundario. Utilice la [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operación para buscar el identificador de jerarquía en la respuesta.

**Para encontrar un ID de jerarquía**
+ Ejecute el siguiente comando para describir el activo principal. {{parent-asset-id}}Sustitúyalo por el identificador del activo principal o el identificador externo.

  ```
  aws iotsitewise describe-asset --asset-id {{parent-asset-id}}
  ```

  La operación devuelve una respuesta que contiene los detalles del activo. La respuesta contiene una lista `assetHierarchies` que tiene la siguiente estructura:

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

  El ID de jerarquía es el valor `id` para una jerarquía en la lista de jerarquías de activos.

Después de tener el ID de jerarquía, puede asociar o disociar un activo con esa jerarquía.

Para asociar un activo secundario a un activo principal, utilice la [AssociateAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateAssets.html)operación. Para desasociar un activo secundario de un activo principal, utilice la [DisassociateAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DisassociateAssets.html)operación. Especifique los siguientes parámetros, que son los mismos para ambas operaciones:
+ `assetId`: ID del activo principal o ID externo.
+ `hierarchyId`: ID de jerarquía o ID externo en el activo principal.
+ `childAssetId`: ID del activo secundario o ID externo.

**Asociación de un activo (AWS CLI)**
+ Ejecute el siguiente comando para asociar un activo secundario con un activo principal. Sustituya {{parent-asset-id}}{{hierarchy-id}}, y {{child-asset-id}} por lo respectivo IDs:

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

**Disociación de un activo (AWS CLI)**
+ Ejecute el siguiente comando para disociar un activo secundario de un activo principal. Sustitúyase {{parent-asset-id}}{{hierarchy-id}}, y {{child-asset-id}} por lo respectivo IDs:

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