使用自定义清单

使用 AWS CLI 删除或关闭自定义清单

1. 安装并配置 AWS Command Line Interface（AWS CLI）（如果尚未执行该操作）。

   有关信息，请参阅安装或更新 AWS CLI 的最新版本。

2. 运行以下命令来使用 dry-run 选项查看将从系统中删除哪些数据。此命令不会删除任何数据。

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

   系统将返回类似于以下内容的信息。

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

   有关如何了解和删除清单摘要的信息，请参阅 了解删除清单摘要。

3. 运行以下命令来删除自定义清单类型的所有数据。

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

   注意

   此命令的输出未显示删除进度。因此，TotalCount (总计数) 和 Remaining Count (剩余计数) 始终相同，因为系统尚未删除任何数据。您可以使用 describe-inventory-deletions 命令来显示删除进度，如本主题的下文所述。

   系统将返回类似于以下内容的信息。

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

   系统将从 Systems Manager Inventory 服务中删除指定的自定义清单类型的所有数据。

4. 运行以下命令。此命令对清单类型的当前版本执行以下操作：关闭当前版本、删除其所有数据，并在版本低于或等于已关闭版本时忽略所有新数据。

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

   系统将返回类似于以下内容的信息。

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

   您可以使用以下命令查看已关闭的清单类型。

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

5. 运行以下命令来删除清单类型。

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

   系统将删除指定的自定义类型的架构和所有清单数据。

   系统将返回类似于以下内容的信息。

   {
      "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. 运行以下命令来查看删除操作的状态。系统将返回 delete-inventory 摘要中的删除 ID。

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

   系统将返回最新状态。删除操作可能尚未完成。系统将返回类似于以下内容的信息。

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

   如果删除操作成功，则 LastStatusMessage 指出：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. 运行以下命令来查看最近 30 天运行的所有删除的列表。

   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"

为删除清单操作配置 EventBridge

1. 打开位于 https://console.aws.amazon.com/events/ 的 Amazon EventBridge 控制台。

2. 在导航窗格中，选择规则。

3. 选择创建规则。

4. 为规则输入名称和描述。

   规则不能与同一区域中的另一个规则和同一事件总线上的名称相同。

5. 对于事件总线，请选择要与此规则关联的事件总线。如果您希望此规则响应来自您自己的 AWS 账户的匹配事件，请选择 defaul（默认）。当您账户中的某个 AWS 服务发出一个事件时，它始终会发送到您账户的默认事件总线。

6. 对于规则类型，选择具有事件模式的规则。

7. 选择下一步。

8. 对于事件源，选择AWS 事件或 EventBridge 合作伙伴事件。

9. 在 Event pattern（事件模式）部分，选择 Event pattern form（事件模式表单）。

10. 对于事件源，选择AWS 服务。

11. 对于 service（AWS 服务），选择 Systems Manager。

12. 对于 Event type (事件类型)，选择 Inventory (清单)。

13. 对于 Specific detail type(s)（具体详细信息类型），选择 Inventory Resource State Change（清单资源状态更改）。

14. 选择下一步。

15. 对于目标类型，选择AWS 服务。

16. 对于 Select a target（选择一个目标），选择 SNS topic（SNS 主题），然后对于 Topic（主题），选择您的主题。

17. 在 Additional settings（其他设置）部分，对于 Configure target input（配置目标输入），请验证已选择 Matched event（匹配的事件）。

18. 选择下一步。

19. （可选）为规则输入一个或多个标签。有关更多信息，请参阅 Amazon EventBridge 用户指南中的标记 Amazon EventBridge 资源。

20. 选择 Next（下一步）。

21. 查看规则详细信息并选择创建规则。