Descrizione ed elencazione degli stack

Puoi usare due AWS CLI comandi per ottenere informazioni sui tuoi AWS CloudFormation stack: e. aws cloudformation list-stacks aws cloudformation describe-stacks

Nota

Vedi AWS CloudFormation risorse per una discussione su come le politiche IAM possono limitare ciò che un utente può fare con questi due AWS CLI comandi.

aws cloudformation list-stacks

Il comando aws cloudformation list-stacks consente di ottenere un elenco degli eventuali stack creati (anche quelli che sono stati eliminati fino a un massimo di 90 giorni). Puoi utilizzare un'opzione per filtrare i risultati in base allo stato dello stack, ad esempio CREATE_COMPLETE e DELETE_COMPLETE. Il comando aws cloudformation list-stacks restituisce informazioni di riepilogo su uno qualsiasi degli stack in esecuzione o eliminati, inclusi il nome, l'identificatore dello stack, il modello e lo stato.

Nota

Il comando aws cloudformation list-stacks restituisce informazioni su stack eliminati fino a 90 giorni successivi l'eliminazione.

Nell'esempio seguente viene mostrato un riepilogo di tutti gli stack con stato CREATE_COMPLETE.

$ 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

Il comando aws cloudformation describe-stacks fornisce informazioni sugli stack in esecuzione. Puoi utilizzare un'opzione per filtrare i risultati in base a un nome dello stack. Questo comando restituisce informazioni sullo stack, incusi il nome, l'identificatore dello stack e lo stato.

Nell'esempio seguente vengono mostrate informazioni di riepilogo per lo stack myteststack.

$ 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
        }
    ]
}

Se non utilizzi l'opzione --stack-name per limitare l'output a un solo stack, vengono restituite le informazioni su tutti gli stack in esecuzione.

Codici di stato dello stack

Puoi specificare uno o più codici di stato dello stack per elencare solo gli stack con i codici di stato specificati. Nella tabella seguente viene descritto ogni codice di stato dello stack:

Stato dello stack e stato dettagliato opzionale	Descrizione
CREATE_COMPLETE	Creazione di uno o più stack completata.
CREATE_IN_PROGRESS	Creazione di uno o più stack in corso.
CREATE_FAILED	Creazione di uno o più stack non riuscita. Visualizzare gli eventi dello stack per vedere gli eventuali messaggi di errore associati. Le possibili ragioni di una creazione non riuscita includono le autorizzazioni insufficienti per lavorare con tutte le risorse dello stack, i valori dei parametri rifiutati da un AWS servizio o un timeout durante la creazione delle risorse.
DELETE_COMPLETE	Eliminazione di uno o più stack completata. Gli stack eliminati vengono conservati e sono visualizzabili per 90 giorni.
DELETE_FAILED	Eliminazione di uno o più stack non riuscita. Poiché l'eliminazione non è riuscita, è possibile che alcune risorse siano ancora in esecuzione; tuttavia, non è possibile utilizzare o aggiornare lo stack. Eliminare nuovamente lo stack o visualizzare gli eventi dello stack per visualizzare gli eventuali messaggi di errore associati.
DELETE_IN_PROGRESS	Rimozione di uno o più stack in corso.
REVIEW_IN_PROGRESS	Creazione di uno o più stack in corso con un StackId previsto ma senza modelli o risorse. Importante Un stack con questo codice di stato conta fino al raggiungimento del massimo numero possibile di stack.
ROLLBACK_COMPLETE	Rimozione di uno o più stack completata dopo una creazione stack non riuscita o dopo una creazione stack annullata in maniera esplicita. Lo stack torna allo stato di funzionamento precedente. Le eventuali risorse che sono state create durante l'operazione di creazione dello stack vengono eliminate. Questo stato esiste solo dopo una creazione stack non riuscita. Indica che tutte le operazioni dallo stack creato parzialmente sono state opportunamente rimosse. In questo stato, è possibile eseguire solo un'operazione di eliminazione.
ROLLBACK_FAILED	Rimozione di uno o più stack non riuscita dopo una creazione stack non riuscita o dopo una creazione stack annullata in maniera esplicita. Eliminare lo stack o visualizzare gli eventi dello stack per visualizzare gli eventuali messaggi di errore associati.
ROLLBACK_IN_PROGRESS	Rimozione di uno o più stack in corso dopo una creazione stack non riuscita o dopo una creazione stack annullata in maniera esplicita.
UPDATE_COMPLETE	Aggiornamento di uno o più stack completato.
UPDATE_COMPLETE_CLEANUP_IN_PROGRESS	Rimozione in corso di risorse obsolete per uno o più stack dopo un aggiornamento dello stack completato. Per gli aggiornamenti dello stack che richiedono la sostituzione di risorse, CloudFormation crea prima le nuove risorse e poi elimina le vecchie risorse per ridurre eventuali interruzioni dello stack. In questo stato, lo stack è stato aggiornato ed è utilizzabile, ma le vecchie risorse CloudFormation vengono comunque eliminate.
UPDATE_FAILED	Aggiornamento non completato di uno o più stack. Visualizzare gli eventi dello stack per vedere gli eventuali messaggi di errore associati.
UPDATE_IN_PROGRESS	Aggiornamento di uno o più stack in corso.
UPDATE_ROLLBACK_COMPLETE	Restituzione di uno o più stack completata in uno stato attivo precedente dopo un aggiornamento stack non riuscito.
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	Rimozione in corso di nuove risorse per uno o più stack dopo un aggiornamento dello stack non riuscito. In questo stato, lo stack è stato ripristinato allo stato di funzionamento precedente ed è utilizzabile, ma CloudFormation sta comunque eliminando tutte le nuove risorse create durante l'aggiornamento dello stack.
UPDATE_ROLLBACK_FAILED	Restituzione di uno o più stack non riuscita in uno stato attivo precedente dopo un aggiornamento stack non riuscito. In questo stato, puoi eliminare lo stack o continuare il rollback. Prima che lo stack possa tornare in uno stato attivo, potrebbe essere necessario risolvere gli errori. In alternativa, puoi contattare AWS Support per ripristinare lo stack a uno stato utilizzabile.
UPDATE_ROLLBACK_IN_PROGRESS	Restituzione di uno o più stack in corso allo stato attivo precedente dopo un aggiornamento stack non riuscito.
IMPORT_IN_PROGRESS	L'operazione di importazione è attualmente in corso.
IMPORT_COMPLETE	L'operazione di importazione è stata completata correttamente per tutte le risorse nello stack che supportano resource import.
IMPORT_ROLLBACK_IN_PROGRESS	L'importazione verrà ripristinata alla configurazione del modello precedente.
IMPORT_ROLLBACK_FAILED	L'operazione di rollback di importazione non è riuscita per almeno una risorsa nello stack. I risultati saranno disponibili per le risorse importate CloudFormation con successo.
IMPORT_ROLLBACK_COMPLETE	Il rollback dell'importazione alla configurazione del modello precedente è riuscita.