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.

# `AWS-DeregisterAMIs`
<a name="aws-deregisteramis"></a>

 **Description** 

 Le `AWS-DeregisterAMIs` runbook vous aide à désenregistrer Amazon Machine Images (AMIs) en spécifiant la balise que vous avez appliquée à votre. AMIs

 [Exécutez cette automatisation (console) ](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**Type de document **

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

LinuxmacOS, Windows

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.
+ DryRun

  Type : Chaîne

  Valeurs valides : Oui \| Non

  Description : (Obligatoire) Vérifie si vous disposez des autorisations requises pour l'action, sans effectuer réellement la demande, et fournit une réponse d'erreur.
+ RetainNumber

  Type : Chaîne

  Description : (Facultatif) Le numéro AMIs que vous souhaitez conserver. Ne spécifiez pas de valeur pour ce paramètre si vous spécifiez une valeur pour`Age`.
+ Age

  Type : Chaîne

  Description : (Facultatif) Le nombre de jours précédents AMIs que vous souhaitez conserver. Ne spécifiez pas de valeur pour ce paramètre si vous spécifiez une valeur pour`RetainNumber`.
+ TagKey

  Type : Chaîne

  Description : (Obligatoire) La clé de la balise attribuée à celle AMIs que vous souhaitez désenregistrer.
+ TagValue

  Type : Chaîne

  Description : (Obligatoire) La valeur de la balise attribuée à celle AMIs que vous souhaitez désenregistrer.

**Autorisations IAM requises **

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **Étapes de document** 
+  `aws:executeAwsApi`- Valide les valeurs que vous spécifiez pour les paramètres d'entrée du runbook. 
+  `aws:executeAwsApi`- Désenregistrement à AMIs l'aide de la balise que vous avez spécifiée à l'`TagKey`aide des paramètres et. `TagValue`