

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.

# Elimine activos en AWS IoT SiteWise
<a name="delete-assets"></a>

Puede usar la AWS IoT SiteWise consola o la API para eliminar un activo que ya no necesite en su entorno. Al eliminar un modelo de activos, también se eliminan todos los modelos de activos y componentes asociados. Sin embargo, es importante tener en cuenta que eliminar un activo o un modelo es una acción permanente, y que también se eliminarán todos los datos asociados a los recursos eliminados. Antes de eliminar activos o modelos, se recomienda revisar las dependencias o integraciones que puedan verse afectadas y asegurarse de tener una copia de seguridad de todos los datos importantes.

Antes de poder eliminar un activo, primero debe disociar sus activos secundarios y disociarlos de su activo principal. Para obtener más información, consulte [Asociación y desasociación de activos](add-associated-assets.md). Si usa AWS Command Line Interface (AWS CLI), puede usar la [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html)operación para enumerar los elementos secundarios de un activo.

Cuando se elimina un activo, su estado es `DELETING` hasta que se propagan los cambios. Para obtener más información, consulte [Estados de activos y modelos](asset-and-model-states.md). Después de eliminar el activo, no puede consultar ese activo. Si lo hace, la API devuelve una respuesta HTTP 404.

**importante**  
AWS IoT SiteWise elimina todos los datos de propiedad de los activos eliminados.

**Topics**
+ [Eliminación de un activo (consola)](#delete-asset-console)
+ [Eliminación de un activo (AWS CLI)](#delete-asset-cli)

## Eliminación de un activo (consola)
<a name="delete-asset-console"></a>

Puede utilizar la AWS IoT SiteWise consola para eliminar un activo.

**Para eliminar 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 que desea eliminar.
**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. Si el activo tiene **Activos asociados**, elimine cada activo. Puede elegir el nombre de un activo para navegar hasta su página, donde puede eliminarlo.

1. En la página del activo, elija **Eliminar**.

1. En el cuadro de diálogo **Eliminar activo**, haga lo siguiente:

   1. Escriba **Delete** para confirmar la eliminación.

   1. Elija **Eliminar**.

## Eliminación de un activo (AWS CLI)
<a name="delete-asset-cli"></a>

Puede usar el AWS Command Line Interface (AWS CLI) para eliminar un activo.

Utilice la [DeleteAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAsset.html)operación para eliminar un activo. Especifique el siguiente parámetro:
+ `assetId`: el ID del activo. Es el ID real en formato UUID o el `externalId:myExternalId` si lo tiene. Para obtener más información, consulte [Objetos de referencia con objetos externos IDs](object-ids.md#external-id-references) en la *Guía del usuario de AWS IoT SiteWise *.

**Eliminación de un activo (AWS CLI)**

1. Ejecute el siguiente comando para mostrar las jerarquías del activo. {{asset-id}}Sustitúyalo por el ID o el ID externo del activo:

   ```
   aws iotsitewise describe-asset --asset-id {{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}}"
       }
     ],
     {{...}}
   }
   ```

   Para obtener más información, consulte la operación [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html).

1. Para cada jerarquía, ejecute el siguiente comando para mostrar los secundarios del activo que están asociados con esa jerarquía. {{asset-id}}Sustitúyalo por el ID o el ID externo del activo y {{hierarchy-id}} por el ID o el ID externo de la jerarquía.

   ```
   aws iotsitewise list-associated-assets \
     --asset-id {{asset-id}} \
     --hierarchy-id {{hierarchy-id}}
   ```

   Para obtener más información, consulte la operación [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html).

1. Ejecute el siguiente comando para eliminar cada activo asociado y, a continuación, para eliminar el activo. {{asset-id}}Sustitúyalo por el ID o el ID externo del activo.

   ```
   aws iotsitewise delete-asset --asset-id {{asset-id}}
   ```