As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Excluindo um controle personalizado no AWS Audit Manager
Se você criou um controle personalizado e não precisa mais dele, é possível excluí-lo do ambiente do Audit Manager. Isso permite que você limpe seu espaço de trabalho e se concentre nos controles personalizados que são relevantes para suas tarefas e prioridades atuais.
## Pré-requisitos
O procedimento a seguir pressupõe que você já criou um controle personalizado antes.
Certifique-se de que sua identidade do IAM tenha as permissões apropriadas para excluir um controle personalizado no AWS Audit Manager. Duas políticas sugeridas que concedem essas permissões são [AWSAuditManagerAdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAuditManagerAdministratorAccess.html) e [Permita que o gerenciamento de usuários acesse AWS Audit Manager](security_iam_id-based-policy-examples.md#management-access).
## Procedimento
Você pode excluir controles personalizados usando o console do Audit Manager, a API do Audit Manager ou o AWS Command Line Interface (AWS CLI).
**Importante**
Quando você exclui um controle personalizado, essa ação remove o controle de qualquer estrutura ou avaliação personalizada à qual ele esteja relacionado atualmente. Como resultado, o Audit Manager deixará de coletar evidências desse controle personalizado em todas as suas avaliações. Isso inclui avaliações que você criou anteriormente antes de excluir o controle personalizado.
------
#### [ Audit Manager console ]
**Para excluir um controle personalizado no console do Audit Manager**
1. Abra o console do AWS Audit Manager em [https://console.aws.amazon.com/auditmanager/casa](https://console.aws.amazon.com/auditmanager/home).
1. No painel de navegação, escolha **Biblioteca de controle** e, em seguida, escolha a guia **Controles personalizados**.
1. Selecione o controle que você deseja excluir e, em seguida, selecione **Excluir**.
1. Na janela pop-up exibida, escolha **Excluir** para confirmar a exclusão.
------
#### [ AWS CLI ]
**Para excluir um controle personalizado no AWS CLI**
1. Primeiro, identifique o controle personalizado que você deseja excluir. Para fazer isso, execute o comando [list-controls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/list-controls.html) e especifique as `--control-type` como `Custom`.
```
aws auditmanager list-controls --control-type Custom
```
A resposta retorna uma lista de controles personalizados. Encontre o controle que você deseja excluir e anote o ID do controle.
1. Em seguida, execute o comando [delete-control](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/delete-control.html) e use o parâmetro `--control-id` para especificar o controle que você deseja excluir.
No exemplo a seguir, *placeholder text* substitua o por suas próprias informações.
```
aws auditmanager delete-control --control-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
------
#### [ Audit Manager API ]
**Para excluir um controle personalizado usando a API**
1. Use a [ListControls](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html)operação e especifique o [ControlType](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html#auditmanager-ListControls-request-controlType) como`Custom`. Na resposta, encontre o controle que você deseja excluir e anote o ID do controle.
1. Use a [DeleteControl](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html)operação para excluir o controle personalizado. Na solicitação, use o parâmetro [controlId](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html#auditmanager-DeleteControl-request-controlId) para especificar o controle que você deseja excluir.
Para obter mais informações sobre essas operações de API, escolha qualquer um dos links no procedimento anterior para ler mais sobre a *Referência da API AWS Audit Manager *. Isso inclui informações sobre como usar essas operações e parâmetros em um dos idiomas específicos AWS SDKs.
------
## Recursos adicionais do
Para obter mais informações sobre a retenção de dados no Audit Manager, consulte [Exclusão dos dados do Audit Manager](data-protection.md#data-deletion-and-retention).