Einen Änderungssatz für einen CloudFormation Stack 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

1. Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

2. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm Ihre aus. AWS-Region

3. Wählen Sie auf der Seite Stacks den Namen des Stacks aus, der den Änderungssatz enthält, den Sie anzeigen möchten.

4. Wählen Sie im Navigationsbereich die Option Change Sets (Änderungssätze) aus, um eine Liste der Änderungssätze des Stack anzuzeigen.

5. 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 Changes (Änderungen) stellt jede Zeile eine Ressource dar, die von CloudFormation hinzugefügt, geändert oder entfernt 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.

6. 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.

7. 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)

1. Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

2. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm Ihre aus. AWS-Region

3. Wählen Sie auf der Seite Stacks den Namen des Stacks aus, der den Änderungssatz enthält, den Sie anzeigen möchten.

4. Wählen Sie im Navigationsbereich Change Sets aus, um eine Liste der Änderungssets des Stacks anzuzeigen.

5. 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 Changes (Änderungen) steht jede Zeile für eine Ressource, die CloudFormation hinzufügen, ändern oder entfernen wird oder die den Status „Dynamisch“ anzeigen 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.

6. 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.

   Anmerkung

   CloudFormation Änderungssätze auf Eigenschaftsebene lösen stapelübergreifende Verweise nicht auf, wenn Sie Änderungssätze für verschachtelte Stapel erstellen. Änderungssätze können Ressourcen in einem untergeordneten Stapel für die bedingte Ersetzung kennzeichnen, wenn sie auf die Ausgabe eines übergeordneten Stacks verweisen und der übergeordnete Stapel geändert wurde

So zeigen Sie einen Änderungssatz an (AWS CLI)

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

   Geben Sie den Namen des Stacks an, der den Änderungssatz enthält, den Sie anzeigen möchten, wie im folgenden Beispiel gezeigt:

   aws cloudformation list-change-sets --stack-name MyStack

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

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

2. 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/MyStack/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": "MyStack",
       "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 Beispiel für Änderungssätze für CloudFormation Stapel.

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