Uso del inventario personalizado

Para eliminar o desactivar un inventario personalizado mediante la AWS CLI

1. Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).

   Para obtener más información, consulte Instalación o actualización de la última versión de la AWS CLI.

2. Ejecute el siguiente comando para utilizar la opción dry-run con el fin de ver qué datos se eliminarán del sistema. Este comando no elimina ningún dato.

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

   El sistema devuelve información similar a la siguiente.

   {
      "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 obtener información acerca del resumen de eliminaciones del inventario, consulte Explicación del resumen de eliminaciones del inventario.

3. Ejecute el siguiente comando para eliminar todos los datos de un tipo de inventario personalizado.

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

   nota

   El resultado de este comando no muestra el progreso de la eliminación. Por este motivo, TotalCount y Remaining Count siguen siendo iguales, ya que el sistema no ha eliminado nada todavía. Puede utilizar el comando describe-inventory-deletions para mostrar el progreso de la eliminación, tal y como se describe más adelante en este tema.

   El sistema devuelve información similar a la siguiente.

   {
      "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"
   }

   El sistema elimina todos los datos del tipo de inventario personalizado especificado del servicio Systems Manager Inventory.

4. Ejecute el siguiente comando de la . El comando realiza las siguientes acciones para la versión actual del tipo de inventario: desactiva la versión actual, elimina todos los datos correspondientes a ella y omite todos los datos nuevos si la versión es inferior o igual a la versión desactivada.

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

   El sistema devuelve información similar a la siguiente.

   {
      "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"
   }

   Puede ver un tipo de inventario desactivado mediante el siguiente comando.

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

5. Ejecute el siguiente comando para eliminar un tipo de inventario.

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

   El sistema elimina el esquema y todos los datos de inventario del tipo personalizado especificado.

   El sistema devuelve información similar a la siguiente.

   {
      "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. Ejecute el siguiente comando para ver el estado de una operación de eliminación. El sistema devolvió el ID de eliminación en el resumen de eliminaciones del inventario.

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

   El sistema devuelve el estado más reciente. Puede que la operación de eliminación no haya terminado todavía. El sistema devuelve información similar a la siguiente.

   {"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"}
     ]
   }

   Si la operación de eliminación se realiza correctamente, LastStatusMessage indica: Deletion is successful.

   {"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. Ejecute el siguiente comando para ver una lista de todas las eliminaciones realizadas en los últimos 30 días.

   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 EventBridge para la eliminación de operaciones de inventario

1. Abra la consola de Amazon EventBridge en https://console.aws.amazon.com/events/.

2. En el panel de navegación, seleccione Reglas.

3. Elija Crear regla.

4. Escriba un nombre y una descripción para la regla.

   Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.

5. En Bus de eventos, seleccione el bus de eventos que desea asociar a esta regla. Si desea que esta regla responda a eventos coincidentes procedentes de su propia Cuenta de AWS, seleccione default (predeterminado). Cuando un Servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.

6. En Tipo de regla, elija Regla con un patrón de evento.

7. Elija Siguiente.

8. En Origen del evento, elija Eventos de AWS o eventos de socios de EventBridge.

9. En la sección Event pattern (Patrón de eventos), elija Event pattern form (Formulario de patrón de eventos).

10. Para Event source (origen de eventos), elija AWSservices (servicios).

11. En AWS service (Servicio de ), elija Systems Manager.

12. Para Event type (Tipo de evento), elija Inventory (Inventario).

13. En Specific detail type(s) (Tipos de detalles específicos), elija Inventory Resource State Change (Cambio de estado de recursos de inventario).

14. Elija Siguiente.

15. En Target types (Tipos de destino), elija AWS service.

16. En Select a target (Seleccione un destino), elija SNS topic (Tema de SNS) y, a continuación, elija el tema en Topic (Tema).

17. En la sección Additional settings (Ajustes adicionales), en Configure target input (Configurar entrada de destino), verifique que Matched event (Evento coincidente) está seleccionado.

18. Elija Siguiente.

19. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte Etiquetado de los recursos de Amazon EventBridge en la Guía del usuario de Amazon EventBridge.

20. Elija Siguiente.

21. Revise los detalles de la regla y seleccione Crear regla.