View a markdown version of this page

Excluir ativos em AWS IoT SiteWise - AWS IoT SiteWise

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

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. Se você usar o AWS Command Line Interface (AWS CLI), poderá usar a ListAssociatedAssets 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. 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 da 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.

Excluir um ativo (AWS CLI)

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

Use a DeleteAsset 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 Fazer referência a 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. asset-idSubstitua 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 lista de assetHierarchies que tem a seguinte estrutura:

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

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

  2. Para cada hierarquia, execute o seguinte comando para listar os filhos do ativo que estão associados a essa hierarquia. asset-idSubstitua 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 operação ListAssociatedAssets.

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

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