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

# Exclua ativos e modelos em AWS IoT SiteWise
<a name="delete-assets-and-models"></a>

Você pode excluir seus ativos, modelos de ativos, modelos de componentes e interfaces AWS IoT SiteWise quando terminar de usá-los. As operações de exclusão são assíncronas e demoram para se propagar. AWS IoT SiteWise

**Topics**
+ [Excluir ativos em AWS IoT SiteWise](delete-assets.md)
+ [Exclua modelos de ativos, modelos de componentes e interfaces no AWS IoT SiteWise](delete-asset-models.md)

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

# Exclua modelos de ativos, modelos de componentes e interfaces no AWS IoT SiteWise
<a name="delete-asset-models"></a>

Você pode usar o AWS IoT SiteWise console ou a API para excluir um modelo de ativo, modelo de componente ou interface.

Para excluir um modelo de ativo, primeiro é necessário excluir todos os ativos criados por meio do modelo de ativo. Antes de excluir uma interface, você deve primeiro desvinculá-la de todos os modelos de ativos que a implementam.

Quando você exclui um modelo ou interface de ativo, seu status é `DELETING` até que as alterações se propaguem. Para obter mais informações, consulte [Estados de ativos e modelos](asset-and-model-states.md). Depois que o modelo ou a interface do ativo forem excluídos, você não poderá consultar esse modelo ou interface do ativo. Se você fizer isso, a API retornará uma resposta HTTP 404.

**Topics**
+ [Excluir um modelo de ativo, modelo de componente ou interface (console)](#delete-asset-model-console)
+ [Excluir um modelo de ativo, modelo de componente ou interface (AWS CLI)](#delete-asset-model-cli)

## Excluir um modelo de ativo, modelo de componente ou interface (console)
<a name="delete-asset-model-console"></a>

Você pode usar o AWS IoT SiteWise console para excluir um modelo de ativo, modelo de componente ou interface.

**Topics**

**Para excluir um modelo de ativo, modelo de componente ou interface (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-models"></a>No painel de navegação, selecione **Modelos**.

1. Escolha o modelo do ativo, o modelo do componente ou a interface a ser excluída.

1. Se estiver excluindo um modelo de ativo e ele tiver algum **ativo**, exclua cada ativo. Escolha o nome de um ativo para navegar até sua página e poder excluí-lo. Para obter mais informações, consulte [Excluir um ativo (console)](delete-assets.md#delete-asset-console).

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

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

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

   1. Escolha **Excluir**.

## Excluir um modelo de ativo, modelo de componente ou interface (AWS CLI)
<a name="delete-asset-model-cli"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para excluir um modelo de ativo, modelo de componente ou interface.

Use a [DeleteAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAssetModel.html)operação para excluir um modelo de ativo, modelo de componente ou interface. Defina o seguinte parâmetro:
+ `assetModelId` – 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 modelo de ativo (AWS CLI)**

1. Execute o seguinte comando para listar todos os ativos criados usando o modelo. *asset-model-id*Substitua pela ID ou pela ID externa do modelo de ativo.

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

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

1. Se o comando anterior retornar quaisquer ativos do modelo, exclua cada ativo. Para obter mais informações, consulte [Excluir um ativo (AWS CLI)](delete-assets.md#delete-asset-cli).

1. Execute o comando a seguir para excluir o modelo de ativo. *asset-model-id*Substitua pelo ID ou ID externo do modelo de ativo.

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

**Importante**  
 Para evitar a exclusão de um modelo de ativo que foi atualizado simultaneamente desde a última operação de leitura, você deve definir uma solicitação de exclusão condicional. Consulte [Bloqueio positivo para gravações do modelo de ativo](opt-locking-for-model.md).