

AWS Audit Manager 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS Audit Manager 可用性变更](https://docs.aws.amazon.com/audit-manager/latest/userguide/audit-manager-availability-change.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 删除中的自定义控件 AWS Audit Manager
<a name="delete-controls"></a>



如果您创建自定义控件后不再需要该控件，可以将其从 Audit Manager 环境中删除。这样您就能够清理工作空间，专注于处理与当前任务和优先级相关的自定义控件。

## 先决条件
<a name="delete-controls-prequisites"></a>

以下过程假定您之前创建过一个自定义控件。

确保您的 IAM 身份具有在 AWS Audit Manager中删除自定义控件的相应权限。建议通过这两个策略授予这些权限：[AWSAuditManagerAdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAuditManagerAdministratorAccess.html)和[允许用户管理访问 AWS Audit Manager](security_iam_id-based-policy-examples.md#management-access)。

## 过程
<a name="delete-controls-procedure"></a>

您可以使用 Audit Manager 控制台、Audit Manager API 或 AWS Command Line Interface （AWS CLI）删除自定义控件。

**重要**  
删除自定义控件时，此操作会将该控件从当前与之相关的所有自定义框架或评测中移除。因此，Audit Manager 将停止在您的所有评测中为该自定义控件收集证据。这包括您在删除自定义控件之前创建的评测。

------
#### [ Audit Manager console ]

**在 Audit Manager 控制台上删除自定义控件**

1. 在[https://console.aws.amazon.com/auditmanager/家](https://console.aws.amazon.com/auditmanager/home)中打开 AWS Audit Manager 控制台。

1. 在导航窗格中，选择**控件库**，然后选择**自定义控件**选项卡。

1. 选择要删除的控件，然后选择**删除**。

1. 在出现的弹出窗口中，选择**删除**以确认删除。

------
#### [ AWS CLI ]

**要删除中的自定义控件 AWS CLI**

1. 首先，识别要删除的自定义控件。为此，请运行 [list-controls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/list-controls.html) 命令并将 `--control-type` 指定为 `Custom`。

   ```
    aws auditmanager list-controls --control-type Custom
   ```

   响应返回自定义控件列表。找到要删除的控件，并记下控件 ID。

1. 接下来，运行 [delete-control](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/delete-control.html) 命令并使用 `--control-id` 参数指定要删除的控件。

   在以下示例中，{{placeholder text}}用您自己的信息替换。

   ```
   aws auditmanager delete-control --control-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}
   ```

------
#### [ Audit Manager API ]

**使用 API 删除自定义控件**

1. 使用[ListControls](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html)操作并将 [ControlType](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html#auditmanager-ListControls-request-controlType) 指定为。`Custom`在响应中，找到要删除的控件并记下控件 ID。

1. 使用[DeleteControl](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html)操作删除自定义控件。在请求中，使用 [controlId](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html#auditmanager-DeleteControl-request-controlId) 参数指定要删除的控件。

如需了解更多关于这些 API 操作的信息，请选择前面步骤中的任一链接，在《AWS Audit Manager API 参考》中**了解更多内容。这包括有关如何在特定语言 AWS SDKs中使用这些操作和参数的信息。

------

## 其他资源
<a name="delete-controls-additional-resources"></a>

有关 Audit Manager 中的数据留存的更多信息，请参阅[删除 Audit Manager 数据](data-protection.md#data-deletion-and-retention)。