View a markdown version of this page

AWS-DeregisterAMIs - AWS Systems Manager Runbook-Referenz für Automation

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

Beschreibung

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

Führen Sie diese Automatisierung aus (Konsole)

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, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • DryRun

    Typ: Zeichenfolge

    Gültige Werte: Ja | Nein

    Beschreibung: (Erforderlich) Prü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 AnzahlAMIs, die Sie behalten möchten. Geben Sie keinen Wert für diesen Parameter an, wenn Sie einen Wert für angebenAge.

  • 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 angebenRetainNumber.

  • TagKey

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Der Schlüssel des Tags, das dem zugewiesen istAMIs, das Sie abmelden möchten.

  • TagValue

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Der Wert des Tags, das dem zugewiesen istAMIs, das Sie abmelden 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— Hebt die Registrierung AMIs mithilfe des Tags auf, das Sie mit den Parametern und angeben. TagKey TagValue