Excluir ativos

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

Para excluir um ativo, primeiro você deve desassociar seus ativos filho e desassociá-lo do ativo pai. Para ter mais informações, consulte Associar e desassociar ativos. Se você usar o AWS Command Line Interface (AWS CLI), poderá usar a ListAssociatedAssetsoperação para listar os filhos de um ativo.

Ao excluir um ativo, seu status será DELETING até que as alterações sejam propagadas. Para ter mais informações, consulte Estados de ativos e modelos. 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.

Excluir um ativo (console)

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

Para excluir um ativo (console)

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação, selecione Ativos.

3. Escolha o ativo a ser excluído.

   dica

   Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

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

5. Na página do ativo, escolha Excluir.

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

   1. Insira Delete para confirmar a exclusão.

   2. Escolha Excluir.

Excluindo um ativo ()AWS CLI

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

Use a DeleteAssetoperaçã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. Para obter mais informações, consulte Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .

Para excluir um ativo (AWS CLI)

1. Execute o seguinte comando para listar as hierarquias do ativo. Substitua asset-id pelo ID ou pelo ID externo 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 assetHierarchies lista com a seguinte estrutura:

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

   Para obter mais informações, consulte a DescribeAssetoperação.

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

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

   Para obter mais informações, consulte a ListAssociatedAssetsoperação.

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

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