Trabalhar com inventário personalizado

Para excluir ou desativar o inventário personalizado usando a AWS CLI

1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.

   Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

2. Execute o seguinte comando para usar a opção dry-run para ver quais dados serão excluídos do sistema. Esse comando não exclui nenhum dado.

   aws ssm delete-inventory --type-name "Custom:custom_type_name" --dry-run

   O sistema retorna informações como estas.

   {
      "DeletionSummary":{
         "RemainingCount":3,
         "SummaryItems":[
            {
               "Count":2,
               "RemainingCount":2,
               "Version":"1.0"
            },
            {
               "Count":1,
               "RemainingCount":1,
               "Version":"2.0"
            }
         ],
         "TotalCount":3
      },
      "TypeName":"Custom:custom_type_name"
   }

   Para obter informações sobre como entender o resumo de exclusão do inventário, consulte Noções básicas sobre o resumo de exclusão do inventário.

3. Execute o seguinte comando para excluir todos os dados de um tipo de inventário personalizado.

   aws ssm delete-inventory --type-name "Custom:custom_type_name"

   nota

   O resultado desse comando não mostra o andamento da exclusão. Por esse motivo, TotalCount (Total) e Remaining Count (Restante) são sempre os mesmos porque o sistema ainda não excluiu nada. Você pode usar o comando "describe-inventory-deletions" para mostrar o andamento da exclusão, conforme descrito mais adiante neste tópico.

   O sistema retorna informações como estas.

   {
      "DeletionId":"system_generated_deletion_ID",
      "DeletionSummary":{
         "RemainingCount":3,
         "SummaryItems":[
            {
               "Count":2,
               "RemainingCount":2,
               "Version":"1.0"
            },
            {
               "Count":1,
               "RemainingCount":1,
               "Version":"2.0"
            }
         ],
         "TotalCount":3
      },
      "TypeName":"custom_type_name"
   }

   O sistema exclui todos os dados do tipo de inventário personalizado especificado no serviço do Systems Manager Inventory.

4. Execute o seguinte comando . O comando executa as seguintes ações para a versão atual do tipo de inventário: desativa a versão atual, exclui todos os dados dela e ignora todos os novos dados se a versão for anterior ou igual à versão desativada.

   aws ssm delete-inventory --type-name "Custom:custom_type_name" --schema-delete-option "DisableSchema"

   O sistema retorna informações como estas.

   {
      "DeletionId":"system_generated_deletion_ID",
      "DeletionSummary":{
         "RemainingCount":3,
         "SummaryItems":[
            {
               "Count":2,
               "RemainingCount":2,
               "Version":"1.0"
            },
            {
               "Count":1,
               "RemainingCount":1,
               "Version":"2.0"
            }
         ],
         "TotalCount":3
      },
      "TypeName":"Custom:custom_type_name"
   }

   Você pode visualizar um tipo de inventário desativado, usando o comando a seguir.

   aws ssm get-inventory-schema --type-name Custom:custom_type_name

5. Execute o seguinte comando para excluir um tipo de inventário.

   aws ssm delete-inventory --type-name "Custom:custom_type_name" --schema-delete-option "DeleteSchema"

   O sistema exclui o esquema e todos os dados de inventário do tipo personalizado especificado.

   O sistema retorna informações como estas.

   {
      "DeletionId":"system_generated_deletion_ID",
      "DeletionSummary":{
         "RemainingCount":3,
         "SummaryItems":[
            {
               "Count":2,
               "RemainingCount":2,
               "Version":"1.0"
            },
            {
               "Count":1,
               "RemainingCount":1,
               "Version":"2.0"
            }
         ],
         "TotalCount":3
      },
      "TypeName":"Custom:custom_type_name"
   }

1. Execute o seguinte comando para visualizar o status de uma operação de exclusão. O sistema retornou o ID de exclusão no resumo de exclusão do inventário.

   aws ssm describe-inventory-deletions --deletion-id system_generated_deletion_ID

   O sistema retorna o status mais recente. A operação de exclusão pode não estar concluída. O sistema retorna informações como estas.

   {"InventoryDeletions": 
     [
       {"DeletionId": "system_generated_deletion_ID", 
        "DeletionStartTime": 1521744844, 
        "DeletionSummary": 
         {"RemainingCount": 1, 
          "SummaryItems": 
           [
             {"Count": 1, 
              "RemainingCount": 1, 
              "Version": "1.0"}
           ], 
          "TotalCount": 1}, 
        "LastStatus": "InProgress", 
        "LastStatusMessage": "The Delete is in progress", 
        "LastStatusUpdateTime": 1521744844, 
        "TypeName": "Custom:custom_type_name"}
     ]
   }

   Se a operação de exclusão for bem-sucedida, a mensagem LastStatusMessage indica: Exclusão bem-sucedida.

   {"InventoryDeletions": 
     [
       {"DeletionId": "system_generated_deletion_ID", 
        "DeletionStartTime": 1521744844, 
        "DeletionSummary": 
         {"RemainingCount": 0, 
          "SummaryItems": 
           [
             {"Count": 1, 
              "RemainingCount": 0, 
              "Version": "1.0"}
           ], 
          "TotalCount": 1}, 
        "LastStatus": "Complete", 
        "LastStatusMessage": "Deletion is successful", 
        "LastStatusUpdateTime": 1521745253, 
        "TypeName": "Custom:custom_type_name"}
     ]
   }

2. Execute o seguinte comando para visualizar uma lista de todas as exclusões executadas nos últimos 30 dias.

   aws ssm describe-inventory-deletions --max-results a number

   {"InventoryDeletions": 
     [
       {"DeletionId": "system_generated_deletion_ID", 
        "DeletionStartTime": 1521682552, 
        "DeletionSummary": 
         {"RemainingCount": 0, 
          "SummaryItems": 
           [
             {"Count": 1, 
              "RemainingCount": 0, 
              "Version": "1.0"}
           ], 
          "TotalCount": 1}, 
        "LastStatus": "Complete", 
        "LastStatusMessage": "Deletion is successful", 
        "LastStatusUpdateTime": 1521682852, 
        "TypeName": "Custom:custom_type_name"}, 
       {"DeletionId": "system_generated_deletion_ID", 
        "DeletionStartTime": 1521744844, 
        "DeletionSummary": 
         {"RemainingCount": 0, 
          "SummaryItems": 
           [
             {"Count": 1, 
              "RemainingCount": 0, 
              "Version": "1.0"}
           ], 
          "TotalCount": 1}, 
        "LastStatus": "Complete", 
        "LastStatusMessage": "Deletion is successful", 
        "LastStatusUpdateTime": 1521745253, 
        "TypeName": "Custom:custom_type_name"}, 
       {"DeletionId": "system_generated_deletion_ID", 
        "DeletionStartTime": 1521680145, 
        "DeletionSummary": 
         {"RemainingCount": 0, 
          "SummaryItems": 
           [
             {"Count": 1, 
              "RemainingCount": 0, 
              "Version": "1.0"}
           ], 
          "TotalCount": 1}, 
        "LastStatus": "Complete", 
        "LastStatusMessage": "Deletion is successful", 
        "LastStatusUpdateTime": 1521680471, 
        "TypeName": "Custom:custom_type_name"}
     ], 
    "NextToken": "next-token"

Para configurar o EventBridge para excluir operações de inventário

1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Regras.

3. Escolha Create rule.

4. Insira um nome e uma descrição para a regra.

   Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.

5. Em Barramento de eventos, selecione o barramento de eventos que você deseja associar a essa regra. Se você quiser que essa regra responda a eventos correspondentes provenientes da sua Conta da AWS, selecione default (padrão). Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

6. Em Tipo de Regra, escolha Regra com Padrão de Evento.

7. Escolha Próximo.

8. Em Event source, escolha Eventos da AWS ou eventos de parceiro do EventBridge.

9. Na seção Event patter (Padrão de evento), selecione Event pattern form (Formulário de padrão de evento).

10. Em Fonte do evento, selecione Serviços da AWS.

11. Em Serviço da AWS, escolha Systems Manager.

12. Para Event type (Tipo de evento), escolha Inventory (Inventário).

13. Em Specific detail type(s) (Tipos de detalhes específicos), escolha Inventory Resource State Change (Alteração de estado de recursos de inventário).

14. Escolha Next (Avançar).

15. Em Tipos de destino, escolha Serviço da AWS.

16. Em Select a target (Selecionar um destino), escolha SNS topic (Tópico do SNS) e depois escolha seu tópico em Topic.

17. Na seção Additional settings (Configurações adicionais), para Configure target input (Configurar entrada do destino), verifique se a opção Matched event (Evento correspondido) está selecionada.

18. Escolha Próximo.

19. (Opcional) Insira uma ou mais tags para a regra. Para obter mais informações, consulte Marcar recursos do Amazon EventBridge no Guia do usuário do Amazon EventBridge.

20. Escolha Próximo.

21. Analise os detalhes da regra e selecione Criar regra.