Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 **Beschreibung** 

 Das `AWS-DeregisterAMIs` Runbook hilft Ihnen beim Abmelden Amazon Machine Images (AMIs), indem es das Tag angibt, das Sie auf Ihr angewendet haben. AMIs

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ DryRun

  Typ: Zeichenfolge

  Gültige Werte: Ja \$1 Nein

  Beschreibung: (Erforderlich) Überprüft, ob Sie über die erforderlichen Berechtigungen für die Aktion verfügen, ohne die Anfrage tatsächlich zu stellen, und gibt eine Fehlermeldung aus.
+ RetainNumber

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die NummerAMIs, die Sie behalten möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für angeben`Age`.
+ Age

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der vorherigen TageAMIs, die Sie behalten möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für angeben`RetainNumber`.
+ TagKey

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Schlüssel des Tags, das dem Tag zugewiesen istAMIs, dessen Registrierung Sie aufheben möchten.
+ TagValue

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Wert des Tags, das dem Tag zugewiesen istAMIs, dessen Registrierung Sie aufheben möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **Dokumentschritte** 
+  `aws:executeAwsApi`- Überprüft die Werte, die Sie für die Runbook-Eingabeparameter angeben. 
+  `aws:executeAwsApi`- Die Registrierung wird AMIs mit dem Tag aufgehoben, das Sie mit den Parametern und angegeben haben. `TagKey` `TagValue`