Actualizar grupos de consultas basados en etiquetas

Los siguientes procedimientos muestran cómo actualizar un grupo de consultas basado en etiquetas.

Console

Actualizar un grupo basado en etiquetas cambiando los tipos de recursos o etiquetas de la consulta en la que se basa el grupo. También puede añadir o modificar la descripción del grupo.

1. Inicie sesión en la Consola de AWS Resource Groups.

2. En el panel de navegación, en Resource Groups guardados, seleccione un grupo y, a continuación, seleccione Editar.

   nota

   Solo puede actualizar los grupos de recursos de su propiedad. La columna Propietario muestra la propiedad de la cuenta de cada grupo de recursos. Se crearon en AWS License Manager todos los grupos con un propietario de cuenta distinto del grupo en el que has iniciado sesión. Para obtener más información, consulte Grupos de recursos de host de AWS License Manager en la Guía del usuario de License Manager.

3. En la página Editar grupo, dentro de Criterios de agrupación, añada o elimine tipos de recursos. Puede incluir un máximo de 20 tipos de recursos en una consulta. Para eliminar un tipo de recurso, elija X en la etiqueta del tipo de recurso. Elija View group resources (Ver recursos del grupo) para ver cómo afectan los cambios a los recursos que forman el grupo. En este tutorial, agregamos el tipo de recurso AWS: :RDS:: DBInstance a la consulta.

4. Aún dentro de Criterios de agrupación, edite las etiquetas según sea necesario. En este ejemplo, filtramos los recursos que tienen un clave de etiqueta Stage (Etapa) y añadimos un valor de etiqueta Test (Pruebas). El valor de la etiqueta es opcional, pero permite limitar aún más los resultados de la consulta. Para eliminar una etiqueta, seleccione X en el rótulo de la etiqueta.

5. En Información adicional, puede editar la descripción del grupo. No puede editar el nombre de un grupo después de crearlo.

6. (Opcional) En Etiquetas del grupo, puede añadir o eliminar etiquetas. Las etiquetas del grupo son metadatos sobre el grupo de recursos. No afectan a los recursos que lo componen. Para cambiar los recursos que devuelve la consulta del grupo de recursos, edite las etiquetas del área Criterios de agrupación.

   Las etiquetas del grupo son útiles si tiene previsto que este grupo vaya a formar parte de un grupo más grande. Para crear un grupo, es necesario especificar al menos una clave de etiqueta. Por lo tanto, asegúrese de añadir al menos una clave de etiqueta en Etiquetas de grupo a los grupos que planea anidar en grupos más grandes.

7. Seleccione Vista previa de los recursos del grupo para recuperar la lista actualizada de EC2 instancias, buckets S3 e instancias de bases de datos de Amazon RDS de su cuenta que coinciden con las claves de etiqueta especificadas. Si no ve los recursos que esperaba en la lista, asegúrese de que estos estén etiquetados con las etiquetas que ha especificado en Criterios de agrupación.

8. Cuando haya terminado, elija Guardar cambios.

AWS CLI & AWS SDKs

En el AWS CLI, se actualiza la consulta de un grupo y se actualiza la descripción de un grupo de recursos mediante dos comandos diferentes. No se puede editar el nombre de un grupo existente. En el AWS CLI, puede cambiar un grupo basado en etiquetas a un grupo CloudFormation basado en pilas o viceversa.

1. Si no desea cambiar la descripción del grupo, omita este paso y continúe en el siguiente. En una AWS CLI sesión, escriba lo siguiente y, a continuación, presione Entrar y sustituya los valores del nombre y la descripción del grupo por los suyos propios.

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

   El siguiente comando es un ejemplo.

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

   El comando devuelve una descripción completa actualizada del grupo.

2. Para actualizar la consulta y las etiquetas de un grupo, escriba el siguiente comando. Sustituya los valores del nombre del grupo, los tipos de recursos, las claves de las etiquetas y los valores de las etiquetas por los suyos. Luego pulse Intro. Puede incluir un máximo de 20 tipos de recursos en una consulta.

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"],\"TagFilters\":[{\"Key\":\"Key1\",\"Values\":[\"Value1\",\"Value2\"]},{\"Key\":\"Key2\",\"Values\":[\"Value1\",\"Value2\"]}]}"}'

   El siguiente comando es un ejemplo.

   $ aws resource-groups update-group-query \
       --group-name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\",\"AWS::RDS::DBInstance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   El comando devuelve la consulta actualizada como resultado.