Einen Änderungssatz anzeigen

Nach dem Erstellen eines Änderungssatzes können Sie die vorgeschlagenen Änderungen vor der Ausführung anzeigen. Sie können die CloudFormation Konsole oder verwenden AWS CLI, CloudFormation API um Änderungssätze anzuzeigen. Die CloudFormation Konsole bietet eine Zusammenfassung der Änderungen und eine detaillierte Liste der JSON Formatänderungen. Die AWS CLI und AWS CloudFormation API geben eine detaillierte Liste der JSON Formatänderungen zurück.

View a change set (console)

Um einen Änderungssatz anzuzeigen

Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie in der Navigationsleiste oben auf dem Bildschirm Ihre aus. AWS-Region
Wählen Sie auf der Seite Stacks den Namen des Stacks aus, der den Änderungssatz enthält, den Sie anzeigen möchten.
Wählen Sie im Navigationsbereich die Option Change Sets (Änderungssätze) aus, um eine Liste der Änderungssätze des Stack anzuzeigen.
Wählen Sie den Namen des Änderungssatzes aus, den Sie anzeigen möchten.

Die CloudFormation Konsole leitet Sie zur Detailseite des Änderungssatzes weiter, auf der Sie den Zeitpunkt der Erstellung des Änderungssatzes, seinen Status, die zur Generierung des Änderungssatzes verwendeten Eingaben und eine Zusammenfassung der Änderungen sehen können.

Im Abschnitt Änderungen steht jede Zeile für eine Ressource, die hinzugefügt, geändert oder entfernt CloudFormation wird.
- Hinzufügen — CloudFormation erstellt eine Ressource, wenn Sie der Vorlage des Stacks eine Ressource hinzufügen.
- Ändern — CloudFormation ändert eine Ressource, wenn Sie die Eigenschaften einer Ressource in der Vorlage des Stacks ändern.
- Entfernen — CloudFormation löscht eine Ressource, wenn Sie eine Ressource aus der Vorlage des Stacks löschen.
Anmerkung
Eine Änderung kann dazu führen, dass die Ressource unterbrochen oder ersetzt (neu erstellt) werden muss. Weitere Informationen zum Verhalten von Ressourcenaktualisierungen finden Sie unter Verstehen Sie das Aktualisierungsverhalten von Stack-Ressourcen.

Um bestimmte Änderungen anzuzeigen, verwenden Sie die Filteransicht. Filtern Sie beispielsweise nach einem bestimmten Ressourcentyp, z. B. AWS::EC2::Instance. Geben Sie zum Filtern nach einer bestimmten Ressource die logische oder physische ID an, z. B. myWebServer oder i-123abcd4.
Wählen Sie im Abschnitt Änderungen in der Spalte Änderungen auf Eigenschaftsebene die Option Details anzeigen aus, um die an Ihrer Ressource vorgenommenen Änderungen am Eigenschaftswert anzuzeigen.
Die CloudFormation Konsole leitet Sie zur Seite mit Änderungen auf Eigenschaftsebene für eine Ressource weiter, auf der Sie die Vorlagenkonfiguration der Ressource vor der Ausführung eines Änderungssatzes sehen und sehen können, wie die Vorlagenkonfiguration nach der Ausführung des Änderungssatzes aussehen wird.

In der Tabelle mit Änderungen auf Eigenschaftsebene werden Pfad, Änderungstyp, Wert vor und Nachher für die betroffenen Eigenschaften angezeigt. Aktivieren Sie in der Tabelle das Kontrollkästchen für jede Änderung, die Sie in der Vorher - und Nachher-Ansicht Ihrer Vorlage hervorheben möchten, um zu sehen, welche Änderungen auf Eigenschaftsebene vorgenommen werden.
- Hinzufügen — Hinzugefügte Eigenschaften sind grün hervorgehoben.
- Ändern — Geänderte Eigenschaften sind blau markiert.
- Entfernen — Entfernte Eigenschaften sind rot markiert.

View a change set for nested stack (console)

So zeigen Sie einen Änderungssatz für verschachtelte Stacks an (Konsole)

Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie in der Navigationsleiste oben auf dem Bildschirm Ihre aus. AWS-Region
Wählen Sie auf der Seite Stacks den Namen des Stacks aus, der den Änderungssatz enthält, den Sie anzeigen möchten.
Wählen Sie im Navigationsbereich Change Sets aus, um eine Liste der Änderungssets des Stacks anzuzeigen.
Wählen Sie den Namen des Änderungssatzes aus, den Sie anzeigen möchten.

Die CloudFormation Konsole leitet Sie zur Detailseite des Änderungssets weiter, auf der Sie den Zeitpunkt der Erstellung des Änderungssatzes, seinen Status, die zur Generierung des Änderungssatzes verwendeten Eingaben und eine Zusammenfassung der Änderungen sehen können.

Im Abschnitt „Änderungen“ steht jede Zeile für eine Ressource, CloudFormation die hinzugefügt, geändert, entfernt oder deren Status als dynamisch angezeigt wird.
- Hinzufügen — CloudFormation erstellt eine Ressource, wenn Sie der Vorlage des Stacks eine Ressource hinzufügen.
- Ändern — CloudFormation ändert eine Ressource, wenn Sie die Eigenschaften einer Ressource in der Vorlage des Stacks ändern.
- Entfernen — CloudFormation löscht eine Ressource, wenn Sie eine Ressource aus der Vorlage des Stacks löschen.
- Dynamisch — Die genaue Aktion zur Änderung der Ressource CloudFormation kann anhand der Vorlage des verschachtelten Stacks nicht ermittelt werden.
Anmerkung
Eine Änderung kann dazu führen, dass die Ressource unterbrochen oder ersetzt (neu erstellt) werden muss. Weitere Informationen zum Verhalten von Ressourcenaktualisierungen finden Sie unter Verstehen Sie das Aktualisierungsverhalten von Stack-Ressourcen.

Um bestimmte Änderungen anzuzeigen, verwenden Sie die Filteransicht. Filtern Sie beispielsweise nach einem bestimmten Ressourcentyp, z. B. AWS::CloudFormation::Stack. Geben Sie zum Filtern nach einer bestimmten Ressource die logische oder physische ID an, z. B. DeadLetterQueue oder NestedStack.
Wählen Sie im Abschnitt Änderungen die Option Verschachtelten Änderungssatz anzeigen des verschachtelten Änderungssatzes, den Sie anzeigen möchten.

Die CloudFormation Konsole leitet Sie zur Detailseite des verschachtelten Änderungssatzes weiter. Sie können Zu Root-Änderungssatz gehen wählen, um den Root-Änderungssatz anzuzeigen, oder Sie können Übergeordneten Änderungssatz anzeigen wählen, um den übergeordneten Änderungssatz anzuzeigen. Weitere Informationen finden Sie unter Änderungssätze für verschachtelte Stacks.
Wählen Sie im Abschnitt Änderungen in der Spalte Änderungen auf Eigenschaftsebene die Option Details anzeigen aus, um detaillierte Änderungen an den Eigenschaftswerten einer Ressource anzuzeigen.
Die CloudFormation Konsole leitet Sie zur Seite mit Änderungen auf Eigenschaftsebene für eine Ressource weiter, auf der Sie die Vorlagenkonfiguration der Ressource vor der Ausführung eines Änderungssatzes sehen und sehen können, wie die Vorlagenkonfiguration nach der Ausführung des Änderungssatzes aussehen wird.

In der Tabelle mit Änderungen auf Eigenschaftsebene werden Pfad, Änderungstyp, Wert vor und Nachher für die betroffenen Eigenschaften angezeigt. Aktivieren Sie in der Tabelle das Kontrollkästchen für jede Änderung, die Sie in der Vorher - und Nachher-Ansicht Ihrer Vorlage hervorheben möchten, um zu sehen, welche Änderungen auf Eigenschaftsebene vorgenommen werden.
- Hinzufügen — Hinzugefügte Eigenschaften sind grün hervorgehoben.
- Ändern — Geänderte Eigenschaften sind blau markiert.
- Entfernen — Entfernte Eigenschaften sind rot markiert.

So zeigen Sie einen Änderungssatz an (AWS CLI)

Um die ID des Änderungssatzes abzurufen, führen Sie den change-setsBefehl.

Geben Sie wie im folgenden Beispiel dargestellt die Stack-ID des Stack mit dem Änderungssatz an, den Sie anzeigen möchten:


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

CloudFormation gibt eine Liste von Änderungssätzen zurück, die der folgenden ähnelt:


{
    "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"
        }
    ]
}

Ausführen des sdescribe-change-setBefehl, der die ID des Änderungssatzes angibt, den Sie anzeigen möchten. Beispielsweise:


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

CloudFormation gibt Informationen über den angegebenen Änderungssatz zurück.


{
    "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"
}

Verwenden Sie --include-property-values withdescribe-change-set, um die Änderungen auf Eigenschaftsebene aufzulisten.

Der Changes-Schlüssel listet Änderungen an Ressourcen auf. Wenn Sie diesen Änderungssatz ausführen CloudFormation würden, würden die Tags der i-1abc23d4 EC2 Instanz aktualisiert. Eine Beschreibung der einzelnen Felder finden Sie in der AWS CloudFormation APIReferenz zum jeweiligen ChangeDatentyp.

Weitere Beispiele von Änderungssätzen finden Sie unter Exemplarische Änderungssätze.

Um Änderungen auf Eigenschaftsebene in einem Änderungssatz anzuzeigen ()AWS CLI

Der folgende Befehl listet die Änderungen auf Eigenschaftsebene auf, die sich auf einen Änderungssatz für eine AWS::EC2::NetworkInterface Ressource beziehen. Dadurch wird die Ipv4Prefixes Eigenschaft entfernt, die Description für die Ressource geändert und Folgendes hinzugefügt: 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

Es folgt eine Beispielausgabe.


"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",

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Einen Änderungssatz erstellen

Einen Änderungssatz ausführen