Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Utilizar `CreateGroup` con una CLI Los siguientes ejemplos de código muestran cómo utilizar `CreateGroup`. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: crear un grupo de recursos basado en etiquetas** En el siguiente ejemplo de `create-group`, se crea un grupo de recursos basado en etiquetas de instancias de Amazon EC2 de la región actual. Se basa en una consulta de recursos que están etiquetados con la clave `Name` y el valor `WebServers`. El nombre del grupo es `tbq-WebServer`. La consulta se encuentra en un archivo JSON independiente que se pasa al comando. ``` aws resource-groups create-group \ --name tbq-WebServer \ --resource-query file://query.json ``` Contenido de `query.json`: ``` { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } ``` Salida: ``` { "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\"]}]}" } } ``` **Ejemplo 2: Para crear un grupo de CloudFormation recursos basado en pilas** En el siguiente `create-group` ejemplo, se crea un grupo de recursos AWS CloudFormation basado en pilas denominado. `sampleCFNstackgroup` La consulta incluye todos los recursos de la CloudFormation pila especificada que son compatibles con AWS Resource Groups. ``` aws resource-groups create-group \ --name cbq-CFNstackgroup \ --resource-query file://query.json ``` Contenido de `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\"}" } ``` Salida: ``` { "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\"}"}' } } ``` Para obtener más información, consulte [Create Groups](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html) en la *Guía del usuario de AWS Resource Groups*. + Para obtener más información sobre la API, consulte [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/create-group.html)la *Referencia de AWS CLI comandos*. ------ #### [ PowerShell ] **Herramientas para la PowerShell versión 4** **Ejemplo 1: En este ejemplo se crea un nuevo grupo de AWS recursos Resource Groups basado en etiquetas denominado TestPowerShellGroup. El grupo incluye instancias de Amazon EC2 de la región actual etiquetadas con la clave de etiqueta “Name” y el valor de etiqueta “test2”. El comando devuelve la consulta y el tipo de grupo, así como los resultados de la operación.** ``` $ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group." ``` **Salida:** ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK ``` + Para obtener más información sobre la API, consulte [CreateGroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (*V4). **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se crea un nuevo grupo de AWS recursos Resource Groups basado en etiquetas denominado TestPowerShellGroup. El grupo incluye instancias de Amazon EC2 de la región actual etiquetadas con la clave de etiqueta “Name” y el valor de etiqueta “test2”. El comando devuelve la consulta y el tipo de grupo, así como los resultados de la operación.** ``` $ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group." ``` **Salida:** ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK ``` + Para obtener más información sobre la API, consulte [CreateGroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ------