Excluir ativos e modelos - 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 e modelos

Você pode excluir seus ativos e modelos 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

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 operação DescribeAsset.

  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 operação ListAssociatedAssets.

  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

Excluir modelos de ativo

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

Antes de excluir um modelo de ativo, você deve primeiro excluir todos os ativos que foram criados a partir do modelo de ativo.

Ao excluir um modelo de 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 modelo de ativo for excluído, não será possível consultá-lo. Se você fizer isso, a API retornará uma resposta HTTP 404.

Excluir um modelo de ativo (console)

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

Tópicos
    Como excluir um modelo de ativo (console)
    1. Navegue até o console do AWS IoT SiteWise.

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

    3. Escolha o modelo de ativo a ser excluído.

    4. Se o modelo tiver Ativos, exclua cada ativo. Escolha o nome de um ativo para navegar até sua página e poder excluí-lo. Para ter mais informações, consulte Excluir um ativo (console).

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

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

      1. Insira Delete para confirmar a exclusão.

      2. Escolha Excluir.

    Excluindo um modelo de ativo ()AWS CLI

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

    Use a DeleteAssetModeloperação para excluir um modelo de ativo. Defina o seguinte parâmetro:

    • assetModelId – 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 modelo de ativo (AWS CLI)
    1. Execute o seguinte comando para listar todos os ativos criados usando o modelo. asset-model-idSubstitua 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.

    2. Se o comando anterior retornar quaisquer ativos do modelo, exclua cada ativo. Para ter mais informações, consulte Excluindo um ativo ()AWS CLI.

    3. Execute o comando a seguir para excluir o modelo de ativo. asset-model-idSubstitua pelo ID ou ID externo do modelo de ativo.

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