aws:deleteStack – Löschen Sie ein AWS CloudFormation-Stack - AWS Systems Manager

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:deleteStack – Löschen Sie ein AWS CloudFormation-Stack

Löscht einen AWS CloudFormation-Stack.

Eingabe

YAML
name: deleteStack action: aws:deleteStack maxAttempts: 1 onFailure: Abort inputs: StackName: "{{stackName}}"
JSON
{ "name":"deleteStack", "action":"aws:deleteStack", "maxAttempts":1, "onFailure":"Abort", "inputs":{ "StackName":"{{stackName}}" } }
ClientRequestToken

Ein eindeutiger Bezeichner für diese DeleteStack-Anfrage. Geben Sie dieses Token an, wenn Sie planen, Anfragen zu wiederholen, damit CloudFormation weiß, dass Sie nicht versuchen, einen Stack mit demselben Namen zu löschen. Sie können DeleteStack-Anfragen wiederholen, um zu verifizieren, ob CloudFormation sie empfangen hat.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Muster: [a-zA-Z][-a-zA-Z0-9]*

Erforderlich: Nein

RetainResources.member.N

Diese Eingabe gilt nur für Stacks im Status DELETE_FAILED. Eine Liste der logischen Ressourcen-IDs für die Ressourcen, die Sie beibehalten möchten. Während des Löschvorgangs löscht CloudFormation den Stack, löscht jedoch die aufbewahrten Ressourcen nicht.

Das Aufbewahren der Ressourcen ist nützlich, wenn Sie eine Ressource nicht löschen können, wie etwa einen nicht leeren S3-Bucket, Sie aber den Stack löschen möchten.

Typ: Zeichenfolge-Array

Erforderlich: Nein

RoleARN

Der Amazon-Ressourcenname (ARN) für eine AWS Identity and Access Management-(IAM)-Rolle, die CloudFormation zum Erstellen des Stacks annimmt. CloudFormation verwendet die Anmeldeinformationen der Rolle, um Anrufe in Ihrem Auftrag zu tätigen. CloudFormation verwendet diese Rolle stets für alle künftigen Vorgänge am Stack. Wenn Benutzer die Berechtigung für Vorgänge am Stack besitzen, verwendet CloudFormation diese Rolle auch dann, wenn die Benutzer nicht über die Berechtigung zur Weitergabe verfügen. Stellen Sie sicher, dass die Rolle die geringstmögliche Menge an Berechtigungen gewährt.

Wenn Sie keinen Wert angeben, verwendet CloudFormation die Rolle, die dem Stack vorher zugeordnet war. Wenn keine Rolle verfügbar ist, verwendet CloudFormation eine temporäre Sitzung, die anhand Ihrer Benutzeranmeldeinformationen generiert wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Nein

StackName

Der Name oder die eindeutige Stack-ID, die dem Stack zugeordnet ist.

Typ: Zeichenfolge

Erforderlich: Ja

Sicherheitsüberlegungen

Bevor Sie die Aktion aws:deleteStack verwenden können, müssen Sie folgende Richtlinie der IAM-Automation-Assume-Role zuweisen. Weitere Informationen über die Übernahmerolle finden Sie unter Aufgabe 1: Erstellen einer Servicerolle für Automation.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "sqs:*", "cloudformation:DeleteStack", "cloudformation:DescribeStacks" ], "Resource":"*" } ] }