Affichage de la liste des piles et description

Vous pouvez utiliser deux AWS CLI commandes pour obtenir des informations sur vos AWS CloudFormation piles : aws cloudformation list-stacks etaws cloudformation describe-stacks.

Note

Voir AWS CloudFormation ressources pour une discussion sur la façon dont les politiques IAM peuvent limiter ce qu'un utilisateur peut faire avec ces deux AWS CLI commandes.

aws cloudformation list-stacks

La commande aws cloudformation list-stacks vous permet d'obtenir une liste des piles que vous avez créées (y compris celles qui ont été supprimées au cours des 90 derniers jours). Vous pouvez utiliser une option pour filtrer les résultats par état de la pile, comme CREATE_COMPLETE et DELETE_COMPLETE. La commande aws cloudformation list-stacks renvoie des informations récapitulatif sur les piles cours d'exécution ou supprimées, y compris leur nom, leur identifiant, leur modèle et leur état.

Note

La commande aws cloudformation list-stacks renvoie des informations sur les piles supprimées au cours des 90 derniers jours.

L'exemple suivant présente un résumé de toutes les piles ayant l'état 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

La commande aws cloudformation describe-stacks fournit des informations sur les piles en cours d'exécution. Vous pouvez utiliser une option pour filtrer les résultats en fonction du nom de la pile. Cette commande renvoie des informations sur la pile, y compris le nom, l'identifiant et l'état.

L'exemple suivant présente les informations récapitulatives de la pile 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
        }
    ]
}

Si vous n'utilisez pas l'option --stack-name pour limiter la sortie à une seule pile, vous recevrez les informations relatives à tous les piles en cours d'exécution.

Codes d'état de la pile

Vous pouvez spécifier un ou plusieurs codes d'état pour n'afficher que les listes correspondantes. Le tableau suivant décrit chaque code d'état d'une pile :

État de la pile et statut détaillé facultatif	Description
CREATE_COMPLETE	Réussite de la création d'une ou de plusieurs piles.
CREATE_IN_PROGRESS	Création en cours d'une ou de plusieurs piles.
CREATE_FAILED	Échec de la création d'une ou de plusieurs piles. Affichez les événements de la pile pour voir les messages d'erreur associés. Les raisons possibles d'un échec de création incluent des autorisations insuffisantes pour utiliser toutes les ressources de la pile, des valeurs de paramètres rejetées par un AWS service ou un délai d'attente lors de la création des ressources.
DELETE_COMPLETE	Réussite de la suppression d'une ou de plusieurs piles. Les piles supprimées sont conservées et consultables pendant 90 jours.
DELETE_FAILED	Échec de la suppression d'une ou de plusieurs piles. Comme la suppression a échoué, certaines ressources sont peut-être encore en cours d'exécution. Cependant, vous ne pouvez pas utiliser ni mettre à jour la pile. Supprimez la pile à nouveau ou consultez les événements correspondants pour voir les messages d'erreur associés.
DELETE_IN_PROGRESS	Suppression en cours d'une ou de plusieurs piles.
REVIEW_IN_PROGRESS	Création continue d'une ou de plusieurs piles avec un StackId attendu, mais sans aucun modèle ni ressource. Important Une pile associée à ce code de statut est comptabilisée dans le nombre maximal possible de piles.
ROLLBACK_COMPLETE	Réussite de la suppression d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile. La pile revient à son état de fonctionnement précédent. Toutes les ressources qui ont été créées au cours de l'action de création de la pile sont supprimées. Ce statut existe uniquement après un échec de création de la pile. Il signifie que toutes les opérations de la pile partiellement créée ont été correctement nettoyées. Dans ce cas-là, seule une opération de suppression peut être effectuée.
ROLLBACK_FAILED	Échec de la suppression d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile. Supprimez la pile ou consultez les événements correspondants pour voir les messages d'erreur associés.
ROLLBACK_IN_PROGRESS	Suppression en cours d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile.
UPDATE_COMPLETE	Réussite de la mise à jour d'une ou de plusieurs piles.
UPDATE_COMPLETE_CLEANUP_IN_PROGRESS	Suppression en cours d'anciennes ressources pour une ou plusieurs piles après une mise à jour réussie. Pour les mises à jour de pile qui nécessitent le remplacement de ressources, CloudFormation créez d'abord les nouvelles ressources, puis supprimez les anciennes ressources afin de réduire les interruptions de votre pile. Dans cet état, la pile a été mise à jour et est utilisable, mais les anciennes ressources CloudFormation sont toujours supprimées.
UPDATE_FAILED	Réussite de la mise à jour d'une ou de plusieurs piles. Affichez les événements de la pile pour voir les messages d'erreur associés.
UPDATE_IN_PROGRESS	Mise à jour en cours d'une ou de plusieurs piles.
UPDATE_ROLLBACK_COMPLETE	Réussite de la restauration de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour.
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	Suppression en cours des nouvelles ressources d'une ou de plusieurs piles après un échec de mise à jour. Dans cet état, la pile a été rétablie à son état de fonctionnement précédent et est utilisable, mais CloudFormation les nouvelles ressources créées lors de la mise à jour de la pile sont toujours supprimées.
UPDATE_ROLLBACK_FAILED	Échec de la restauration de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour. Dans ce cas là, vous pouvez supprimer la pile ou poursuivre la restauration. Vous devrez peut-être corriger les erreurs avant que votre pile puisse revenir à un état de fonctionnement. Vous pouvez également contacter AWS Support pour restaurer la pile dans un état utilisable.
UPDATE_ROLLBACK_IN_PROGRESS	Restauration en cours de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour.
IMPORT_IN_PROGRESS	L'opération d'importation est en cours.
IMPORT_COMPLETE	L'opération d'importation a été exécutée avec succès pour toutes les ressources de la pile qui prennent en charge resource import.
IMPORT_ROLLBACK_IN_PROGRESS	L'importation sera restaurée à la configuration précédente du modèle.
IMPORT_ROLLBACK_FAILED	L'opération de restauration de l'importation a échoué pour au moins une ressource de la pile. Les résultats seront disponibles pour les ressources importées CloudFormation avec succès.
IMPORT_ROLLBACK_COMPLETE	L'importation a été restaurée avec succès à la configuration du modèle précédente.