Aktualisieren Sie eine AWS CloudFormation stapelbasierte Gruppe

Die folgenden Verfahren zeigen Ihnen, wie Sie eine CloudFormation stapelbasierte Gruppe aktualisieren.

Console

Sie können eine AWS CloudFormation stapelbasierte Gruppe nicht in eine tagbasierte Gruppe in der ändern. AWS Management Console Sie können jedoch den Stack ändern, auf dem die Gruppe basiert, oder die Stack-Ressourcentypen ändern, die Sie in die Gruppe aufnehmen möchten. Sie können auch die Beschreibung der Gruppe hinzufügen oder ändern.

1. Melden Sie sich an der AWS Resource Groups -Konsole an.

2. Wählen Sie im Navigationsbereich unter Gespeicherte Ressourcengruppen den Namen der Gruppe aus, und klicken Sie dann auf Bearbeiten.

3. Anmerkung

   Sie können nur Ressourcengruppen aktualisieren, deren Eigentümer Sie sind. In der Spalte Besitzer wird die Kontoinhaberschaft für jede Ressourcengruppe angezeigt. Alle Gruppen mit einem anderen Kontoinhaber als dem, bei dem Sie angemeldet sind, wurden erstellt AWS License Manager. Weitere Informationen finden Sie unter Host-Ressourcengruppen AWS License Manager im License Manager Manager-Benutzerhandbuch.

4. Um auf der Seite Gruppe bearbeiten unter Gruppierungskriterien den Stack zu ändern, auf dem Ihre Gruppe basiert, wählen Sie den Stack aus der Dropdownliste aus. Eine Ressourcengruppe kann nur auf einem einzelnen Stack basieren. Um die Liste der Stacks zu filtern, beginnen Sie mit der Eingabe des Namens des Stacks. Nur Stacks mit unterstützten Statusarten werden in der Liste angezeigt. Die Liste der unterstützten Statusarten finden Sie unter Erstellen von abfragebasierten Gruppen in AWS Resource Groups in diesem Handbuch.

5. Fügen Sie Ressourcentypen hinzu oder entfernen Sie Ressourcentypen. Nur im Stack verfügbare Ressourcentypen werden in der Dropdown-Liste angezeigt. Der Standardwert ist All supported resource types (Alle unterstützten Ressourcentypen). Sie können maximal 20 Ressourcentypen in einer Abfrage verwenden. Um einen Ressourcentyp zu entfernen, wählen Sie das X auf der Beschriftung des Ressourcentyps aus. Weitere Informationen dazu, welche Ressourcentypen unterstützt werden und in der Gruppe enthalten sein können, finden Sie unter Ressourcentypen, die Sie mit AWS Resource Groups und dem Tag-Editor verwenden können.

6. Wählen Sie Gruppenressourcen in der Vorschau anzeigen, um die Liste der Ressourcen im AWS CloudFormation Stapel abzurufen, die Ihren ausgewählten Ressourcentypen entsprechen.

7. Im Bereich Additional information (Zusätzliche Informationen) können Sie die Beschreibung der Gruppe bearbeiten. Sie können den Namen einer Gruppe nicht mehr bearbeiten, nachdem die Gruppe erstellt wurde.

8. Fügen Sie in Group tags (Gruppen-Tags) Tags hinzu oder entfernen Sie Tags. Gruppen-Tags sind Metadaten für Ihre Ressourcengruppe. Sie haben keine Auswirkungen auf Mitgliedsressourcen. Um die Ressourcen zu ändern, die von der Abfrage der Ressourcengruppe zurückgegeben werden, bearbeiten Sie die Tags in Grouping criteria (Gruppierungskriterien).

   Gruppen-Tags sind nützlich, wenn Sie diese Gruppe zum Mitglied einer größeren Gruppe machen möchten. Zum Erstellen einer Gruppe ist die Angabe mindestens eines Tag-Schlüssels erforderlich. Stellen Sie daher sicher, dass Sie Gruppen, die Sie zu größeren Gruppen zusammenfügen möchten, mindestens einen Tagschlüssel unter Gruppen-Tags hinzufügen.

9. Klicken Sie auf Save changes (Änderungen speichern), wenn Sie fertig sind.

AWS CLI & AWS SDKs

In der AWS CLI aktualisieren Sie die Abfrage einer Gruppe und die Beschreibung einer Ressourcengruppe mithilfe von zwei verschiedenen Befehlen. Die Namen vorhandener Gruppen können nicht bearbeitet werden. In der AWS CLI können Sie eine tagbasierte Gruppe in eine CloudFormation stapelbasierte Gruppe ändern oder umgekehrt.

1. Wenn Sie die Beschreibung Ihrer Gruppe nicht ändern möchten, überspringen Sie diesen Schritt und fahren mit dem nächsten Schritt fort. Führen Sie den folgenden Befehl aus und ersetzen Sie die Werte für Gruppenname und Beschreibung durch Ihre eigenen.

   $ aws resource-groups update-group \
       --group-name "resource-group-name" \
       --description "description_text"

   Nachfolgend finden Sie einen Beispielbefehl.

   $ aws resource-groups update-group \
       --group-name "My-CFN-stack-group" \
       --description "EC2 instances, S3 buckets, and RDS DBs that we are using for the test stage."

   Der Befehl gibt eine vollständige und aktualisierte Beschreibung der Gruppe zurück.

2. Führen Sie den folgenden Befehl aus, um die Abfrage und die Tags einer Gruppe zu aktualisieren. Ersetzen Sie die Werte für Gruppenname, Stack-ID und Ressourcentypen durch Ihre eigenen. Um Ressourcentypen hinzuzufügen, geben Sie die vollständige Liste der Ressourcentypen im Befehl an, nicht nur die Ressourcentypen, die Sie hinzufügen. Sie können maximal 20 Ressourcentypen in einer Abfrage verwenden.

   Das stack_identifier ist der Stack-ARN, wie im Beispielbefehl gezeigt.

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --description "description" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

   Nachfolgend finden Sie einen Beispielbefehl.

   $ aws resource-groups update-group-query \
       --group-name "my-resource-group" \
       --description "Updated CloudFormation stack-based group" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:810000000000:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

   Der Befehl gibt als Ergebnis die aktualisierte Abfrage zurück.