Afficher un ensemble de modifications

Après avoir créé un jeu de modifications, vous pouvez afficher les modifications proposées avant de les exécuter. Vous pouvez utiliser la CloudFormation console AWS CLI, ou CloudFormation API pour consulter les ensembles de modifications. La CloudFormation console fournit un résumé des modifications et une liste détaillée des modifications de JSON format. Le AWS CLI and AWS CloudFormation APIrenvoie une liste détaillée des modifications de JSON format.

View a change set for nested stack (console)

Pour afficher un ensemble de modifications pour les piles imbriquées (console)

Dans la CloudFormation console, dans Stacks, choisissez le nom de la pile contenant l'ensemble de modifications que vous souhaitez consulter.
Dans le volet de navigation, choisissez Change sets pour afficher la liste des ensembles de modifications de la pile.
Choisissez le nom de l’ensemble de modifications que vous souhaitez afficher.

La CloudFormation console vous dirige vers la page de détails de l'ensemble de modifications, où vous pouvez voir l'heure à laquelle l'ensemble de modifications a été créé, son statut, les entrées utilisées pour générer l'ensemble de modifications et un résumé des modifications.

Dans la section Modifications, chaque ligne représente une ressource qui CloudFormation ajoutera, modifiera, supprimera ou affichera le statut de dynamique.
- Ajouter : CloudFormation crée une ressource lorsque vous ajoutez une ressource au modèle de la pile.
- Modifier : CloudFormation modifie une ressource lorsque vous modifiez les propriétés d'une ressource dans le modèle de la pile.
- Supprimer : CloudFormation supprime une ressource lorsque vous supprimez une ressource du modèle de la pile.
- Dynamique : CloudFormation impossible de déterminer l'action exacte de modification des ressources à partir du modèle de la pile imbriquée.
Note
Une modification peut entraîner l'interruption ou le remplacement (ou la recréation) de la ressource. Pour plus d'informations sur les mises à jour de ressources, consultez Comprendre les comportements de mise à jour des ressources de pile.

Pour cibler des modifications spécifiques, utilisez la vue filtre. Par exemple, filtrez un type de ressource spécifique, tel que AWS::CloudFormation::Stack. Pour filtrer une ressource spécifique, spécifiez son ID physique ou logique, tel que DeadLetterQueue ou NestedStack.
Dans la section Modifications , choisissez Afficher l’ensemble de modifications imbriqué de l’ensemble de modifications imbriqué que vous souhaitez afficher.

La CloudFormation console vous dirige vers la page de détails de l'ensemble de modifications imbriqué. Vous pouvez choisir Accéder à l’ensemble de modifications racine pour afficher l’ensemble de modifications racine ou choisissez Afficher l’ensemble de modifications parent pour afficher l’ensemble de modifications parent. Pour de plus amples informations, veuillez consulter Modifier les ensembles pour les piles imbriquées.
Dans la section Modifications, choisissez Afficher les détails dans la colonne Modifications au niveau des propriétés pour afficher les modifications détaillées apportées aux valeurs des propriétés d'une ressource.
La CloudFormation console vous dirige vers la page des modifications au niveau de la propriété d'une ressource, où vous pouvez voir la configuration du modèle de la ressource avant d'exécuter un ensemble de modifications et à quoi ressemblera la configuration du modèle après l'exécution de l'ensemble de modifications.

Le tableau de la section Modifications au niveau de la propriété indique le chemin, le type de modification, la valeur avant et la valeur après pour les propriétés concernées. Dans le tableau, cochez la case correspondant à chaque modification que vous souhaitez mettre en évidence dans les vues Avant et Après de votre modèle pour voir quelles modifications seront apportées au niveau des propriétés.
- Ajouter — Les propriétés ajoutées sont surlignées en vert.
- Modifier — Les propriétés modifiées sont surlignées en bleu.
- Supprimer — Les propriétés supprimées sont surlignées en rouge.

View a change set (console)

Pour afficher un ensemble de modifications (console)

Dans la CloudFormation console, dans Stacks, choisissez le nom de la pile contenant l'ensemble de modifications que vous souhaitez consulter.
Dans le volet de navigation, choisissez Jeux de modifications pour afficher la liste des jeux de modifications de la pile.
Choisissez le nom de l’ensemble de modifications que vous souhaitez afficher.

La CloudFormation console vous dirige vers la page de détails de l'ensemble de modifications, où vous pouvez voir l'heure à laquelle l'ensemble de modifications a été créé, son statut, les entrées utilisées pour générer l'ensemble de modifications et un résumé des modifications.

Dans la section Modifications, chaque ligne représente une ressource qui CloudFormation sera ajoutée, modifiée ou supprimée.
- Ajouter : CloudFormation crée une ressource lorsque vous ajoutez une ressource au modèle de la pile.
- Modifier : CloudFormation modifie une ressource lorsque vous modifiez les propriétés d'une ressource dans le modèle de la pile.
- Supprimer : CloudFormation supprime une ressource lorsque vous supprimez une ressource du modèle de la pile.
Note
Une modification peut entraîner l'interruption ou le remplacement (ou la recréation) de la ressource. Pour plus d'informations sur les mises à jour de ressources, consultez Comprendre les comportements de mise à jour des ressources de pile.

Pour cibler des modifications spécifiques, utilisez la vue filtre. Par exemple, filtrez un type de ressource spécifique, tel que AWS::EC2::Instance. Pour filtrer une ressource spécifique, spécifiez son ID physique ou logique, tel que myWebServer ou i-123abcd4.
Dans la section Modifications, choisissez Afficher les détails dans la colonne Modifications au niveau de la propriété pour afficher les modifications de valeur de propriété apportées à votre ressource.
La CloudFormation console vous dirige vers la page des modifications au niveau de la propriété d'une ressource, où vous pouvez voir la configuration du modèle de la ressource avant d'exécuter un ensemble de modifications et à quoi ressemblera la configuration du modèle après l'exécution de l'ensemble de modifications.

Le tableau de la section Modifications au niveau de la propriété indique le chemin, le type de modification, la valeur avant et la valeur après pour les propriétés concernées. Dans le tableau, cochez la case correspondant à chaque modification que vous souhaitez mettre en évidence dans les vues Avant et Après de votre modèle pour voir quelles modifications seront apportées au niveau des propriétés.
- Ajouter — Les propriétés ajoutées sont surlignées en vert.
- Modifier — Les propriétés modifiées sont surlignées en bleu.
- Supprimer — Les propriétés supprimées sont surlignées en rouge.

Pour consulter un ensemble de modifications (AWS CLI)

Pour obtenir l'ID de l'ensemble de modifications, exécutez change-setscommande.

Spécifiez l'ID de la pile qui possède le jeu de modifications que vous souhaitez afficher, comme illustré dans l'exemple suivant :


aws cloudformation list-change-sets \
    --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000

CloudFormation renvoie une liste d'ensembles de modifications, similaire à ce qui suit :


{
    "Summaries": [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet",
            "CreationTime": "2020-11-18T20:44:05.889Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-conditional",
            "CreationTime": "2020-11-18T21:15:56.398Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-conditional/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-replacement",
            "CreationTime": "2020-11-18T21:03:37.706Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000"
        }
    ]
}

Exécutez le describe-change-setcommande, spécifiant l'ID de l'ensemble de modifications que vous souhaitez consulter. Par exemple :


aws cloudformation describe-change-set \
  --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000

CloudFormation renvoie des informations sur l'ensemble de modifications spécifié.


{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
    "Status": "CREATE_COMPLETE",
    "ChangeSetName": "SampleChangeSet-direct",
    "Parameters": [
        {
            "ParameterValue": "testing",
            "ParameterKey": "Purpose"
        },
        {
            "ParameterValue": "ellioty-useast1",
            "ParameterKey": "KeyPairName"
        },
        {
            "ParameterValue": "t2.micro",
            "ParameterKey": "InstanceType"
        }
    ],
    "Changes": [
        {
            "ResourceChange": {
                "ResourceType": "AWS::EC2::Instance",
                "PhysicalResourceId": "i-1abc23d4",
                "Details": [
                    {
                        "ChangeSource": "DirectModification",
                        "Evaluation": "Static",
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never"
                        }
                    }
                ],
                "Action": "Modify",
                "Scope": [
                    "Tags"
                ],
                "LogicalResourceId": "MyEC2Instance",
                "Replacement": "False"
            },
            "Type": "Resource"
        }
    ],
    "CreationTime": "2020-11-18T23:35:25.813Z",
    "Capabilities": [],
    "StackName": "SampleStack",
    "NotificationARNs": [],
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255"
}

Utilisez --include-property-values with describe-change-set pour répertorier les modifications apportées au niveau des propriétés.

La clé Changes répertorie les modifications apportées aux ressources. Si vous deviez exécuter cet ensemble de modifications, les balises de l'i-1abc23d4EC2instance CloudFormation seraient mises à jour. Pour une description de chaque champ, consultez le type de Changedonnées dans le AWS CloudFormation APIRéférence.

Pour obtenir des exemples supplémentaires de jeux de modifications, consultez la page Exemples de jeux de modifications.

Pour afficher les modifications apportées au niveau des propriétés dans un ensemble de modifications (AWS CLI)

La commande suivante répertorie les modifications au niveau de la propriété liées à un ensemble de modifications pour une AWS::EC2::NetworkInterface ressource qui supprimera la Ipv4Prefixes propriété, modifiera la propriété de la Description ressource et ajoutera un : Tag


aws cloudformation describe-change-set --include-property-values \
  --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841

Voici un exemple de sortie.


"ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:803642222207:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:803642222207:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",
    "StackName": "ExampleStack",
    "Description": null,
    "Parameters": null,
    "CreationTime": "2024-04-09T18:04:59.935000+00:00",
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE",
    "StatusReason": null,
    "NotificationARNs": [],
    "RollbackConfiguration": {
        "RollbackTriggers": []
    },
    "Capabilities": [],
    "Tags": null,
    "ParentChangeSetId": null,
    "IncludeNestedStacks": true,
    "RootChangeSetId": null,
    "OnStackFailure": null,
 {
    "Changes": [
        {
            "Type": "Resource",
            "ResourceChange": {
                "Action": "Modify",
                "LogicalResourceId": "EC2NetworkInterface00eni067fd35b649a05b7100Tpyls",
                "PhysicalResourceId": "eni-067fd35b649a05b71",
                "ResourceType": "AWS::EC2::NetworkInterface",
                "Replacement": "False",
                "Scope": [
                    "Properties",
                    "Tags"
                ],
                "Details": [
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Ipv4Prefixes",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Ipv4Prefixes",
                            "BeforeValue": "[]",
                            "AttributeChangeType": "Remove"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Description",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Description",
                            "BeforeValue": "",
                            "AfterValue": "Description",
                            "AttributeChangeType": "Modify"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Tags/0",
                            "AfterValue": "{\"Key\":\"Test\",\"Value\":\"Test\"}",
                            "AttributeChangeType": "Add"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    }
                ],
                "BeforeContext": "{\"Properties\":{\"Description\":\"\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4Prefixes\":[],\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}",
                "AfterContext": "{\"Properties\":{\"Description\":\"Description\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[{\"Value\":\"Test\",\"Key\":\"Test\"}]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}"
            }
        }
    ],
    "ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Création d'un ensemble de modifications

Exécuter un ensemble de modifications