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

# Excluir ativos em AWS IoT SiteWise
<a name="delete-assets"></a>

Você pode usar o AWS IoT SiteWise console ou a API para excluir um ativo que não é mais necessário em seu ambiente. A exclusão de um modelo de ativo também exclui todos os ativos e modelos de componente associados. No entanto, é importante observar que a exclusão de um ativo ou modelo é uma ação permanente, e todos os dados associados aos recursos excluídos também são removidos. Antes de excluir ativos ou modelos, é recomendável revisar todas as dependências ou integrações que possam ser afetadas e garantir que haja um backup de todos os dados importantes.

Para excluir um ativo, primeiro você deve desassociar seus ativos filho e desassociá-lo do ativo pai. Para obter mais informações, consulte [Associar e desassociar ativos](add-associated-assets.md). Se você usar o AWS Command Line Interface (AWS CLI), poderá usar a [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html)operação para listar os filhos de um ativo.

Ao excluir um ativo, seu status será `DELETING` até que as alterações sejam propagadas. Para obter mais informações, consulte [Estados de ativos e modelos](asset-and-model-states.md). Depois que o ativo for excluído, não será possível consultá-lo. Se você fizer isso, a API retornará uma resposta HTTP 404.

**Importante**  
AWS IoT SiteWise exclui todos os dados de propriedade dos ativos excluídos.

**Topics**
+ [Excluir um ativo (console)](#delete-asset-console)
+ [Excluir um ativo (AWS CLI)](#delete-asset-cli)

## Excluir um ativo (console)
<a name="delete-asset-console"></a>

Você pode usar o AWS IoT SiteWise console para excluir um ativo.

**Para excluir 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 a ser excluído.
**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. Se o ativo tiver **Ativos associados**, exclua cada ativo. Você pode escolher o nome de um ativo para navegar até sua página e poder excluí-lo.

1. Na página do ativo, escolha **Excluir**.

1. Na caixa de diálogo **Excluir ativo**, faça o seguinte:

   1. Insira **Delete** para confirmar a exclusão.

   1. Escolha **Excluir**.

## Excluir um ativo (AWS CLI)
<a name="delete-asset-cli"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para excluir um ativo.

Use a [DeleteAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAsset.html)operação para excluir um ativo. Defina o seguinte parâmetro:
+ `assetId` – O ID do ativo. Esse é o ID real no formato UUID, ou `externalId:myExternalId` se ele tiver um. Consulte mais informações em [Objetos de referência com objetos externos IDs](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *.

**Como excluir um ativo (AWS CLI)**

1. Execute o seguinte comando para listar as hierarquias do ativo. *asset-id*Substitua pela ID ou pela ID externa do ativo:

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

   Para obter mais informações, consulte a operação [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html).

1. Para cada hierarquia, execute o seguinte comando para listar os filhos do ativo que estão associados a essa hierarquia. *asset-id*Substitua pela ID ou ID externa do ativo e *hierarchy-id* pela ID ou ID externa da hierarquia.

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

   Para obter mais informações, consulte a operação [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html).

1. Execute o seguinte comando para excluir cada ativo associado e excluir o ativo. *asset-id*Substitua pelo ID ou ID externo do ativo.

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