Deleting a custom control - AWS Audit Manager

Deleting a custom control

You can use the control library to delete an unwanted custom control. After you delete a control, it no longer appears in the control library. You can also delete custom controls using the Audit Manager API or the AWS Command Line Interface (AWS CLI).

Important

When you delete a custom control, this action removes the control from any custom frameworks or assessments that it's currently related to. As a result, Audit Manager will stop collecting evidence for that custom control in all of your assessments. This includes assessments that you previously created before you deleted the custom control.

Audit Manager console
To delete a custom control (console)

  1. Open the AWS Audit Manager console at https://console.aws.amazon.com/auditmanager/home.

  2. In the navigation pane, choose Control library and then choose the Custom controls tab.

  3. Select the control that you want to delete, and then choose Delete.

  4. In the pop-up window that appears, choose Delete to confirm deletion.

AWS CLI
To delete a custom control (AWS CLI)

  1. First, identify the custom control that you want to delete. To do this, run the list-controls command and specify the --control-type as Custom.

     aws auditmanager list-controls --control-type Custom

    The response returns a list of custom controls. Find the control that you want to delete, and take note of the control ID.

  2. Next, run the delete-control command and use the --control-id parameter to specify the control that you want to delete.

    In the following example, replace the placeholder text with your own information.

    aws auditmanager delete-control --control-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Audit Manager API
To delete a custom control (API)

  1. Use the ListControls operation and specify the controlType as Custom. From the response, find the control that you want to delete and note the control ID.

  2. Use the DeleteControl operation to delete the custom control. In the request, use the controlId parameter to specify the control that you want to delete.

For more information about these API operations, choose any of the previous links to read more in the AWS Audit Manager API Reference. This includes information about how to use these operations and parameters in one of the language-specific AWS SDKs.