Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Beispiele für Resource Groups mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Resource Groups Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-group` Das folgende Codebeispiel zeigt, wie Sie`create-group`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Tag-basierte Ressourcengruppe** Im folgenden Beispiel für `create-group` wird eine Tag-basierte Ressourcengruppe von Amazon-EC2-Instances in der aktuellen Region erstellt. Es basiert auf einer Abfrage nach Ressourcen, die mit dem Schlüssel `Name` und dem Wert `WebServers` gekennzeichnet sind. Der Name der Gruppe lautet `tbq-WebServer`. Die Abfrage befindet sich in einer separaten JSON-Datei, die an den Befehl übergeben wird. ``` aws resource-groups create-group \ --name tbq-WebServer \ --resource-query file://query.json ``` Inhalt von `query.json`: ``` { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer" }, "ResourceQuery": { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } } ``` **Beispiel 2: So erstellen Sie eine CloudFormation stapelbasierte Ressourcengruppe** Im folgenden `create-group` Beispiel wird eine AWS CloudFormation stapelbasierte Ressourcengruppe mit dem Namen erstellt. `sampleCFNstackgroup` Die Abfrage umfasst alle Ressourcen im angegebenen CloudFormation Stack, die von AWS Resource Groups unterstützt werden. ``` aws resource-groups create-group \ --name cbq-CFNstackgroup \ --resource-query file://query.json ``` Inhalt von `query.json`: ``` { "Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}" } ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup", "Name": "cbq-CFNstackgroup" }, "ResourceQuery": { "Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}' } } ``` Weitere Informationen finden Sie unter [Erstellen von Gruppen](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html) im *Benutzerhandbuch für AWS Resource Groups*. + Einzelheiten zur API finden Sie [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/create-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **So aktualisieren Sie die Beschreibung für eine Ressourcengruppe** Im folgenden `delete-group`-Beispiel wird die angegebene Ressourcengruppe aktualisiert. ``` aws resource-groups delete-group \ --group-name tbq-WebServer ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:1234567890:group/tbq-WebServer", "Name": "tbq-WebServer" } } ``` Weitere Informationen finden Sie unter [Löschen von Gruppen](https://docs.aws.amazon.com/ARG/latest/userguide/deleting-resource-groups.html) im *Benutzerhandbuch für AWS Resource Groups*. + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/delete-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-group-query` Das folgende Codebeispiel zeigt die Verwendung`get-group-query`. **AWS CLI** **So rufen Sie die einer Ressourcengruppe zugeordnete Abfrage ab** Im folgenden `get-group-query`-Beispiel wird die Abfrage angezeigt, die der angegebenen Ressourcengruppe zugeordnet ist. ``` aws resource-groups get-group-query \ --group-name tbq-WebServer ``` Ausgabe: ``` { "GroupQuery": { "GroupName": "tbq-WebServer", "ResourceQuery": { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } } } ``` + Einzelheiten zur API finden Sie [GetGroupQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group-query.html)in der *AWS CLI Befehlsreferenz*. ### `get-group` Das folgende Codebeispiel zeigt die Verwendung`get-group`. **AWS CLI** **So rufen Sie Informationen zu einer Ressourcengruppe ab** Im folgenden Beispiel für `get-group` werden Details zur angegebenen Ressourcengruppe angezeigt. Um die Abfrage an die Gruppe anzuhängen, verwenden Sie `get-group-query`. ``` aws resource-groups get-group \ --group-name tbq-WebServer ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer", "Description": "A tag-based query resource group of WebServers." } } ``` + Einzelheiten zur API finden Sie [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-tags` Das folgende Codebeispiel zeigt die Verwendung`get-tags`. **AWS CLI** **So rufen Sie die Tags ab, die einer Ressourcengruppe zugeordnet sind** Im folgenden Beispiel für `get-tags` werden die Tag-Schlüssel- und Wertepaare angezeigt, die der angegebenen Ressourcengruppe (der Gruppe selbst, nicht ihren Mitgliedern) zugeordnet sind. ``` aws resource-groups get-tags \ --arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer ``` Ausgabe: ``` { "Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Tags": { "QueryType": "tags", "QueryResources": "ec2-instances" } } ``` + Einzelheiten zur API finden Sie [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-group-resources` Das folgende Codebeispiel zeigt die Verwendung`list-group-resources`. **AWS CLI** **Um alle Ressourcen in einer Ressourcengruppe aufzulisten** Beispiel 1: Im folgenden Beispiel für `list-resource-groups` werden alle Ressourcen aufgelistet, die Teil der angegebenen Ressourcengruppe sind. ``` aws resource-groups list-group-resources \ --group-name tbq-WebServer ``` Ausgabe: ``` { "ResourceIdentifiers": [ { "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab", "ResourceType": "AWS::EC2::Instance" } ] } ``` Beispiel 2: Im folgenden Beispiel werden alle Ressourcen in der Gruppe aufgelistet, die auch den „resource-type“ „AWS::EC2::Instance“ haben: aws resource-groups list-group-resources --group-name tbq- WebServer --filters name=Ressourcentyp, Values=: :EC2: :Instance AWS + Einzelheiten zur API finden Sie [ListGroupResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-group-resources.html)in *AWS CLI der Befehlsreferenz*. ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So listen Sie die verfügbaren Ressourcengruppen auf** Im folgenden Beispiel für `list-groups` wird eine Liste aller Ressourcengruppen angezeigt. ``` aws resource-groups list-groups ``` Ausgabe: ``` { "GroupIdentifiers": [ { "GroupName": "tbq-WebServer", "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer3" }, { "GroupName": "cbq-CFNStackQuery", "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery" } ], "Groups": [ { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer" }, { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery", "Name": "cbq-CFNStackQuery" } ] } ``` + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-groups` Das folgende Codebeispiel zeigt die Verwendung`list-resource-groups`. **AWS CLI** **Um alle Ressourcen in einer Ressourcengruppe aufzulisten** Im folgenden Beispiel für `list-resource-groups` werden alle Ressourcen aufgelistet, die Teil der angegebenen Ressourcengruppe sind. ``` aws resource-groups list-group-resources \ --group-name tbq-WebServer ``` Ausgabe: ``` { "ResourceIdentifiers": [ { "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab", "ResourceType": "AWS::EC2::Instance" } ] } ``` + Einzelheiten zur API finden Sie [ListResourceGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-resource-groups.html)in der *AWS CLI Befehlsreferenz*. ### `put-group-configuration` Das folgende Codebeispiel zeigt die Verwendung`put-group-configuration`. **AWS CLI** **So hängen Sie eine Servicekonfiguration an eine Ressourcengruppe an** Beispiel 1: Im folgende Beispiel für `put-group-configuration` wird angegeben, dass die Ressourcengruppe nur Amazon-EC2-Kapazitätsreservierungen für Instances der `C5`- oder `M5`-Familien enthalten soll. ``` aws resource-groups put-group-configuration \ --group MyTestGroup \ --configuration file://config.json ``` Inhalt von `config.json`: ``` [ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "allowed-host-families", "Values": [ "c5", "m5" ] }, { "Name": "any-host-based-license-configuration", "Values": [ "true" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ] ``` Dieser Befehl erzeugt keine Ausgabe, wenn er erfolgreich ist. Weitere Informationen finden Sie unter [Servicekonfigurationen für Resource Groups](https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html) im *API-Referenzhandbuch für Ressourcengruppen*. + Einzelheiten zur API finden Sie [PutGroupConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/put-group-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `search-resources` Das folgende Codebeispiel zeigt die Verwendung`search-resources`. **AWS CLI** **So finden Sie Ressourcen, die einer Abfrage entsprechen** Im folgenden `search-resources` Beispiel wird eine Liste aller AWS Ressourcen abgerufen, die der angegebenen Abfrage entsprechen. ``` aws resource-groups search-resources \ --resource-query file://query.json ``` Inhalt von `query.json`: ``` { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Patch Group\", \"Values\":[\"Dev\"]}]}" } ``` Ausgabe: ``` { "ResourceIdentifiers": [ { "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a23bc45d67890ef", "ResourceType": "AWS::EC2::Instance" } ] } ``` + Einzelheiten zur API finden Sie unter [SearchResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/search-resources.html)*Befehlsreferenz.* ### `tag` Das folgende Codebeispiel zeigt die Verwendung`tag`. **AWS CLI** **So hängen Sie ein Tag an eine Ressourcengruppe an** Im folgenden Beispiel für `tag` werden die angegebenen Tag-Schlüssel- und Wertepaare an die angegebene Ressourcengruppe angehängt (die Gruppe selbst, nicht ihre Mitglieder). ``` aws resource-groups tag \ --tags QueryType=tags,QueryResources=ec2-instances \ --arn arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer ``` Ausgabe: ``` { "Arn": "arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer", "Tags": { "QueryType": "tags", "QueryResources": "ec2-instances" } } ``` Weitere Informationen finden Sie unter [Verwalten von Tags](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) im *Benutzerhandbuch für AWS Resource Groups*. + Weitere API-Informationen finden Sie unter [Tag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/tag.html) in der *AWS CLI -Befehlsreferenz*. ### `untag` Das folgende Codebeispiel zeigt die Verwendung`untag`. **AWS CLI** **So entfernen Sie Tags aus einer Ressourcengruppe** Im folgenden Beispiel für `untags` werden alle Tags mit dem angegebenen Schlüssel aus der Ressourcengruppe selbst entfernt, nicht aus ihren Mitgliedern. ``` aws resource-groups untag \ --arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer \ --keys QueryType ``` Ausgabe: ``` { "Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Keys": [ "QueryType" ] } ``` Weitere Informationen finden Sie unter [Verwalten von Tags](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) im *Benutzerhandbuch für AWS Resource Groups*. + Weitere API-Informationen finden Sie unter [Untag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/untag.html) in der *AWS CLI -Befehlsreferenz*. ### `update-group-query` Das folgende Codebeispiel zeigt die Verwendung`update-group-query`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Abfrage für eine Tag-basierte Ressourcengruppe** Im folgenden Beispiel für `update-group-query` wird die Abfrage aktualisiert, die an die angegebene tagbasierte Ressourcengruppe angehängt ist. ``` aws resource-groups update-group-query \ --group-name tbq-WebServer \ --resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}' ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer" }, "ResourceQuery": { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Gruppen](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) im *Benutzerhandbuch für AWS Resource Groups*. **Beispiel 2: Um die Abfrage für eine CloudFormation stapelbasierte Ressourcengruppe zu aktualisieren** Im folgenden `update-group-query` Beispiel wird die Abfrage aktualisiert, die an die angegebene AWS CloudFormation stapelbasierte Ressourcengruppe angehängt ist. ``` aws resource-groups update-group-query \ --group-name cbq-CFNstackgroup \ --resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}' ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup", "Name": "cbq-CFNstackgroup" }, "ResourceQuery": { "Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Gruppen](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) im *Benutzerhandbuch für AWS Resource Groups*. + Einzelheiten zur API finden Sie unter [UpdateGroupQuery AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group-query.html)*Befehlsreferenz*. ### `update-group` Das folgende Codebeispiel zeigt die Verwendung`update-group`. **AWS CLI** **Um die Beschreibung für eine Ressourcengruppe zu aktualisieren** Im folgenden Beispiel für `update-group` wird die Beschreibung für die angegebene Ressourcengruppe aktualisiert. ``` aws resource-groups update-group \ --group-name tbq-WebServer \ --description "Resource group for all web server resources." ``` Ausgabe: ``` { "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer" "Description": "Resource group for all web server resources." } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Gruppen](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) im *Benutzerhandbuch für AWS Resource Groups*. + Einzelheiten zur API finden Sie [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group.html)in der *AWS CLI Befehlsreferenz*.