

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Supprimer un contrôle personnalisé dans AWS Audit Manager
<a name="delete-controls"></a>



Si vous avez créé un contrôle personnalisé et que vous n'en avez plus besoin, vous pouvez le supprimer de votre environnement Audit Manager. Cela vous permet de nettoyer votre espace de travail et de vous concentrer sur les commandes personnalisées adaptées à vos tâches et priorités actuelles.

## Conditions préalables
<a name="delete-controls-prequisites"></a>

La procédure suivante suppose que vous avez déjà créé un contrôle personnalisé.

Assurez-vous que votre identité IAM dispose des autorisations appropriées pour supprimer un contrôle personnalisé dans AWS Audit Manager. Les deux politiques suggérées pour accorder ces autorisations sont [AWSAuditManagerAdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAuditManagerAdministratorAccess.html)et[Autoriser l'accès de gestion des utilisateurs à AWS Audit Manager](security_iam_id-based-policy-examples.md#management-access).

## Procédure
<a name="delete-controls-procedure"></a>

Vous pouvez supprimer des contrôles personnalisés à l'aide de la console Audit Manager, de l'API Audit Manager ou du AWS Command Line Interface (AWS CLI). 

**Important**  
Lorsque vous supprimez un contrôle personnalisé, cette action le supprime de tous les frameworks (ou évaluations) personnalisés auxquels il est actuellement associé. Par conséquent, Audit Manager cesse de collecter des éléments probants pour ce contrôle personnalisé dans toutes vos évaluations. Cela comprend les évaluations que vous avez créées avant de supprimer le contrôle personnalisé.

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

**Pour supprimer un contrôle personnalisé sur la console Audit Manager**

1. Ouvrez la console AWS Audit Manager à la [https://console.aws.amazon.com/auditmanager/maison](https://console.aws.amazon.com/auditmanager/home).

1. Dans le volet de navigation, choisissez **Bibliothèque de contrôles**, puis sélectionnez l’onglet **Contrôles personnalisés**. 

1. Sélectionnez le compte que vous souhaitez supprimer, puis choisissez **Supprimer**.

1. Dans la fenêtre contextuelle qui apparaît, choisissez **Supprimer** pour confirmer la suppression. 

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

**Pour supprimer un contrôle personnalisé dans AWS CLI**

1. Tout d’abord, identifiez le contrôle personnalisé que vous souhaitez supprimer. Pour ce faire, exécutez la commande [list-controls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/list-controls.html) et spécifiez le `--control-type` en tant que `Custom`.

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

   La réponse renvoie une liste de contrôles personnalisés. Recherchez le contrôle que vous souhaitez supprimer et notez son ID.

1. Exécutez ensuite la commande [delete-control](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/delete-control.html) et utilisez le paramètre `--control-id` pour indiquer le contrôle que vous souhaitez supprimer.

   Dans l'exemple suivant, remplacez le *placeholder text* par vos propres informations.

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

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

**Pour supprimer un contrôle personnalisé à l'aide de l'API**

1. Utilisez l'[ListControls](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html)opération et spécifiez le [ControlType](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListControls.html#auditmanager-ListControls-request-controlType) comme`Custom`. Dans la réponse, recherchez le contrôle que vous souhaitez supprimer et notez son ID.

1. Utilisez cette [DeleteControl](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html)opération pour supprimer le contrôle personnalisé. Dans la demande, utilisez le paramètre [ControlID](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeleteControl.html#auditmanager-DeleteControl-request-controlId) pour indiquer le contrôle que vous souhaitez supprimer.

Pour plus d'informations sur ces opérations d'API, cliquez sur l'un des liens de la procédure précédente pour en savoir plus dans la *référence des AWS Audit Manager API*. Cela inclut des informations sur la façon d'utiliser ces opérations et paramètres dans l'un des langages spécifiques. AWS SDKs

------

## Ressources supplémentaires
<a name="delete-controls-additional-resources"></a>

Pour plus d'informations sur la conservation des données dans Audit Manager, consultez[Suppression des données d’Audit Manager](data-protection.md#data-deletion-and-retention).