

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 y modelos en AWS IoT SiteWise
<a name="delete-assets-and-models"></a>

Puede eliminar sus activos, modelos de activos, modelos de componentes e interfaces una AWS IoT SiteWise vez que haya terminado con ellos. Las operaciones de eliminación son asíncronas y tardan un tiempo en propagarse. AWS IoT SiteWise

**Topics**
+ [Elimine activos en AWS IoT SiteWise](delete-assets.md)
+ [Elimine los modelos de activos, los modelos de componentes y las interfaces en AWS IoT SiteWise](delete-asset-models.md)

# 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
   ```

# Elimine los modelos de activos, los modelos de componentes y las interfaces en AWS IoT SiteWise
<a name="delete-asset-models"></a>

Puede utilizar la AWS IoT SiteWise consola o la API para eliminar un modelo de activos, un modelo de componentes o una interfaz.

Antes de poder eliminar un modelo de activos, primero debe eliminar todos los activos creados a partir del modelo de activos. Antes de poder eliminar una interfaz, primero debe desvincularla de todos los modelos de activos que la implementan.

Al eliminar un modelo de activo o una interfaz, su estado es `DELETING` hasta que se propaguen los cambios. Para obtener más información, consulte [Estados de activos y modelos](asset-and-model-states.md). Una vez que se haya eliminado el modelo o la interfaz de activos, no podrá consultar ese modelo o interfaz de activos. Si lo hace, la API devuelve una respuesta HTTP 404.

**Topics**
+ [Elimine un modelo de activos, un modelo de componentes o una interfaz (consola)](#delete-asset-model-console)
+ [Elimine un modelo de activo, un modelo de componentes o una interfaz (AWS CLI)](#delete-asset-model-cli)

## Elimine un modelo de activos, un modelo de componentes o una interfaz (consola)
<a name="delete-asset-model-console"></a>

Puede utilizar la AWS IoT SiteWise consola para eliminar un modelo de activos, un modelo de componentes o una interfaz.

**Topics**

**Para eliminar un modelo de activo, un modelo de componentes o una interfaz (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-models"></a>En el panel de navegación, elija **Models (Modelos)**.

1. Elija el modelo de activo, el modelo de componentes o la interfaz que desee eliminar.

1. Si elimina un modelo de activo y tiene algún **activo**, elimine cada activo. Elija el nombre de un activo para navegar hasta su página, donde puede eliminarlo. Para obtener más información, consulte [Eliminación de un activo (consola)](delete-assets.md#delete-asset-console).

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

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

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

   1. Elija **Eliminar**.

## Elimine un modelo de activo, un modelo de componentes o una interfaz (AWS CLI)
<a name="delete-asset-model-cli"></a>

Puede usar AWS Command Line Interface (AWS CLI) para eliminar un modelo de activos, un modelo de componentes o una interfaz.

Utilice la [DeleteAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAssetModel.html)operación para eliminar un modelo de activos, un modelo de componentes o una interfaz. Especifique el siguiente parámetro:
+ `assetModelId`: 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 modelo de activos (AWS CLI)**

1. Ejecute el siguiente comando para mostrar todos los activos creados a partir del modelo. *asset-model-id*Sustitúyalo por el ID o el ID externo del modelo de activos.

   ```
   aws iotsitewise list-assets --asset-model-id asset-model-id
   ```

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

1. Si el comando anterior devuelve activos del modelo, elimine cada activo. Para obtener más información, consulte [Eliminación de un activo (AWS CLI)](delete-assets.md#delete-asset-cli).

1. Ejecute el siguiente comando para eliminar el modelo de activos. *asset-model-id*Sustitúyalo por el ID o el ID externo del modelo de activos.

   ```
   aws iotsitewise delete-asset-model --asset-model-id asset-model-id
   ```

**importante**  
 Para evitar eliminar un modelo de activos que se ha actualizado simultáneamente desde la última operación de lectura, debe definir una solicitud de eliminación condicional. Consulte [Bloqueo positivo de las escrituras del modelo de activos](opt-locking-for-model.md). 