Beschreiben und Auflisten von Stacks

Du kannst zwei AWS CLI Befehle verwenden, um Informationen über deine AWS CloudFormation Stacks zu erhalten: aws cloudformation list-stacks und. aws cloudformation describe-stacks

Anmerkung

Eine Erläuterung darüber, wie IAM-Richtlinien einschränken können, was ein Benutzer mit diesen beiden AWS CLI Befehlen tun kann, finden AWS CloudFormation Ressourcen Sie unter.

aws cloudformation list-stacks

Mit dem Befehl aws cloudformation list-stacks können Sie eine Liste eines von Ihnen erstellten Stacks abrufen (auch bis zu 90 Tage nach der Löschung). Sie können eine Option zum Filtern der Ergebnisse nach Stack-Status verwenden, z. B. CREATE_COMPLETE und DELETE_COMPLETE. Der Befehl aws cloudformation list-stacks gibt zusammenfassende Informationen über einen Ihrer ausgeführten oder gelöschten Stacks zurück, z. B. Name, Stack-ID, Vorlage und Status.

Anmerkung

Der Befehl aws cloudformation list-stacks gibt Informationen zu gelöschten Stacks bis zu 90 Tage nach der Löschung zurück.

Das folgende Beispiel zeigt eine Übersicht aller Stacks, deren Status CREATE_COMPLETE lautet.

$ aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE
[
    {
        "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/
644df8e0-0dff-11e3-8e2f-5088487c4896",
        "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an
S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.",
        "StackStatusReason": null,
        "CreationTime": "2013-08-26T03:27:10.190Z",
        "StackName": "myteststack",
        "StackStatus": "CREATE_COMPLETE"
    }
]

aws cloudformation describe-stacks

Der Befehl aws cloudformation describe-stacks bietet Informationen zu den ausgeführten Stacks. Sie können eine Option zum Filtern der Ergebnisse nach Stack-Namen verwenden. Dieser Befehl gibt Informationen über den Stack zurück, z. B. Name, Stack-ID und Status.

Das folgende Beispiel zeigt eine Übersicht über den myteststack-Stack:

$ aws cloudformation describe-stacks --stack-name myteststack
{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0",
            "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket.
You will be billed for the AWS resources used if you create a stack from this template.",
            "Tags": [],
            "Outputs": [
                {
                    "Description": "Name of S3 bucket to hold website content",
                    "OutputKey": "BucketName",
                    "OutputValue": "myteststack-s3bucket-jssofi1zie2w"
                }
            ],
            "StackStatusReason": null,
            "CreationTime": "2013-08-23T01:02:15.422Z",
            "Capabilities": [],
            "StackName": "myteststack",
            "StackStatus": "CREATE_COMPLETE",
            "DisableRollback": false
        }
    ]
}

Wenn Sie nicht die Option --stack-name verwenden, um die Ausgabe auf einen Stack zu begrenzen, werden Informationen über alle Ihre laufenden Stacks zurückgegeben.

Stack-Statuscodes

Sie können einen oder mehrere Stack-Statuscodes angeben, um nur Stacks mit dem angegebenen Status zurückzugeben. Die folgende Tabelle enthält die einzelnen Stack-Statuscodes:

Stack-Status und optionaler detaillierter Status	Beschreibung
CREATE_COMPLETE	Erfolgreiche Erstellung eines oder mehrerer Stacks.
CREATE_IN_PROGRESS	Laufende Erstellung eines oder mehrerer Stacks.
CREATE_FAILED	Fehlgeschlagene Erstellung eines oder mehrerer Stacks. Untersuchen Sie die Stack-Ereignisse auf zugehörige Fehlermeldungen. Mögliche Gründe für eine fehlgeschlagene Erstellung sind unzureichende Berechtigungen für die Arbeit mit allen Ressourcen im Stack, von einem AWS Dienst abgelehnte Parameterwerte oder ein Timeout bei der Ressourcenerstellung.
DELETE_COMPLETE	Erfolgreiche Löschung eines oder mehrerer Stacks. Gelöschte Stacks bleiben 90 Tage lang erhalten und anzeigbar.
DELETE_FAILED	Fehlgeschlagene Löschung eines oder mehrerer Stacks. Da der Löschvorgang fehlgeschlagen ist, werden möglicherweise einige Ressourcen noch ausgeführt. Sie können jedoch nicht mit dem Stack arbeiten oder ihn aktualisieren. Löschen Sie den Stack erneut oder untersuchen Sie die Stack-Ereignisse auf zugehörige Fehlermeldungen.
DELETE_IN_PROGRESS	Laufende Entfernung eines oder mehrerer Stacks.
REVIEW_IN_PROGRESS	Laufende Erstellung eines oder mehrerer Stacks mit einer erwarteten StackId, aber ohne Vorlagen oder Ressourcen. Wichtig Ein Stack mit diesem Statuscode wird auf die maximal mögliche Anzahl von Stacks angerechnet.
ROLLBACK_COMPLETE	Erfolgreiche Entfernung eines oder mehrerer Stacks nach einer fehlgeschlagenen Stack-Erstellung oder nach einer explizit abgebrochenen Stack-Erstellung. Der Stack wird in einen früheren funktionsfähigen Zustand zurückgesetzt. Alle Ressourcen, die während des Create Stack-Vorgangs erstellt wurden, werden gelöscht. Dieser Status existiert nur, nachdem das Erstellen eines Stacks fehlgeschlagen ist. Es bedeutet, dass alle Vorgänge aus dem teilweise erstellten Stack entsprechend bereinigt wurden. In diesem Status kann nur einen Löschbefehl ausgeführt werden.
ROLLBACK_FAILED	Fehlgeschlagene Entfernung eines oder mehrerer Stacks nach einer fehlgeschlagenen Stack-Erstellung oder nach einer explizit abgebrochenen Stack-Erstellung. Löschen Sie den Stack oder untersuchen Sie die Stack-Ereignisse auf zugehörige Fehlermeldungen.
ROLLBACK_IN_PROGRESS	Laufende Entfernung eines oder mehrerer Stacks nach einer fehlgeschlagenen Stack-Erstellung oder nach einer explizit abgebrochenen Stack-Erstellung.
UPDATE_COMPLETE	Erfolgreiche Aktualisierung eines oder mehrerer Stacks.
UPDATE_COMPLETE_CLEANUP_IN_PROGRESS	Laufende Entfernung alter Ressourcen für einen oder mehrere Stacks nach einem erfolgreichen Stack-Update. Bei Stack-Updates, bei denen Ressourcen ersetzt werden müssen, CloudFormation erstellt zuerst die neuen Ressourcen und löscht dann die alten Ressourcen, um Unterbrechungen im Stack zu vermeiden. In diesem Zustand wurde der Stack aktualisiert und ist nutzbar, löscht aber CloudFormation immer noch die alten Ressourcen.
UPDATE_FAILED	Nicht erfolgreiche Aktualisierung eines oder mehrerer Stacks. Untersuchen Sie die Stack-Ereignisse auf zugehörige Fehlermeldungen.
UPDATE_IN_PROGRESS	Laufende Aktualisierung eines oder mehrerer Stacks.
UPDATE_ROLLBACK_COMPLETE	Erfolgreiches Zurücksetzen eines oder mehrerer Stacks in einen früheren funktionsfähigen Zustand nach einer fehlgeschlagenen Stack-Aktualisierung.
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	Laufende Entfernung neuer Ressourcen für einen oder mehrere Stacks nach einem fehlgeschlagenen Stack-Update. In diesem Zustand wurde der Stack in seinen vorherigen Betriebszustand zurückgesetzt und ist nutzbar, löscht aber CloudFormation immer noch alle neuen Ressourcen, die er während der Stack-Aktualisierung erstellt hat.
UPDATE_ROLLBACK_FAILED	Fehlgeschlagenes Zurücksetzen eines oder mehrerer Stacks in einen früheren funktionsfähigen Zustand nach einer fehlgeschlagenen Stack-Aktualisierung. In diesem Status können Sie den Stack löschen oder das Rollback fortsetzen. Möglicherweise müssen Sie Fehler beseitigen, um den Stack wieder in einen arbeitsfähigen Zustand zu versetzen. Oder Sie können Kontakt aufnehmen, AWS Support um den Stack wieder in einen verwendbaren Zustand zu versetzen.
UPDATE_ROLLBACK_IN_PROGRESS	Laufendes Zurücksetzen eines oder mehrerer Stacks in den früheren funktionsfähigen Zustand nach einer fehlgeschlagenen Stack-Aktualisierung.
IMPORT_IN_PROGRESS	Der Importvorgang wird derzeit ausgeführt.
IMPORT_COMPLETE	Der Importvorgang wurde für alle Ressourcen im Stack erfolgreich abgeschlossen, die resource import unterstützen.
IMPORT_ROLLBACK_IN_PROGRESS	Der Import wird zur vorherigen Vorlagenkonfiguration zurückgesetzt.
IMPORT_ROLLBACK_FAILED	Der Import-Rollback-Vorgang ist für mindestens eine Ressource im Stack fehlgeschlagen. Die Ergebnisse werden für die CloudFormation erfolgreich importierten Ressourcen verfügbar sein.
IMPORT_ROLLBACK_COMPLETE	Der Import wurde erfolgreich auf die vorherige Vorlagenkonfiguration zurückgesetzt.