Actualización de grupos en AWS Resource Groups

Para actualizar un grupo de recursos basado en etiquetas en Resource Groups, puede editar la consulta y las etiquetas que constituyen la base del grupo. Solo podrá agregar y eliminar recursos del grupo mediante la aplicación de cambios en la consulta o las etiquetas. No se pueden seleccionar recursos específicos para añadirlos al grupo o eliminarlos de este. La mejor forma de añadir o eliminar un recurso específico de un grupo es editar las etiquetas del recurso. A continuación, compruebe que la consulta de etiquetas del grupo de recursos incluye u omite la etiqueta, en función de si desea incluir el recurso en el grupo.

Para actualizar un grupo de recursos basado en una pila de AWS CloudFormation, puede elegir una pila diferente. También puede añadir o eliminar tipos de recursos de la pila que desee que formen parte del grupo. Para cambiar los recursos disponibles en la pila, actualice la plantilla de AWS CloudFormation que ha utilizado para crear la pila y, a continuación, actualice la pila en AWS CloudFormation. Para obtener más información acerca de cómo actualizar una pila de AWS CloudFormation, consulte Actualizaciones de pilas deAWS CloudFormation en la Guía del usuario de AWS CloudFormation

En la AWS CLI, utilice estos dos comandos para actualizar los grupos.

• update-group, para actualizar la descripción de un grupo.

• update-group-query, para actualizar la consulta de recursos y las etiquetas que determinan los recursos que forman parte del grupo.

No puede cambiar un grupo basado en una pila de AWS CloudFormation en la consola por un grupo de consulta basado en etiquetas o viceversa. Sin embargo, puede hacerlo mediante la API de Resource Groups, que se incluye en la AWS CLI.

Actualizar grupos de consultas basados 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 todos los grupos con un propietario de cuenta distinto del grupo en el que has iniciado sesiónAWS License Manager. Para obtener más información, consulte Grupos de recursos de hostAWS 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, añadimos 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. Elija Previsualizar recursos del grupo para obtener la lista actualizada de instancias EC2, buckets de S3 e instancias de base de datos de Amazon RDS de la cuenta que coincidan 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 la AWS CLI, utilizará dos comandos diferentes para actualizar la consulta de un grupo y la descripción de un grupo de recursos. No se puede editar el nombre de un grupo existente. En la AWS CLI puede cambiar un grupo basado en etiquetas por un grupo basado en una pila de CloudFormation o viceversa.

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

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

Actualización de un grupo basado en una pila de AWS CloudFormation

Console

No puede cambiar un grupo basado en una pila de AWS CloudFormation por un grupo basado en etiquetas en la AWS Management Console. Sin embargo, puede cambiar la pila en la que se basa el grupo o cambiar los tipos de recursos de la pila que desee incluir en 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.

3. 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 todos los grupos con un propietario de cuenta distinto del grupo en el que has iniciado sesiónAWS License Manager. Para obtener más información, consulte Grupos de recursos de hostAWS License Manager en la Guía del usuario de License Manager.

4. Para cambiar la pila en la que se basa su grupo, seleccione la pila de la lista desplegable en la página Editar grupo, dentro de Criterios de agrupación. Un grupo de recursos se puede basar solo en una pila. Para filtrar la lista de pilas, empiece a escribir el nombre. En la lista aparecen solo las pilas con estados compatibles. Para obtener una lista de estados compatibles consulte Crear grupos basados en consultas en AWS Resource Groups en esta guía.

5. Añadir o eliminar tipos de recursos. En la lista desplegable solo se muestran los tipos de recursos disponibles en la pila. El valor predeterminado es Todos los tipos de recursos compatibles. 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. Para obtener más información acerca de qué tipos de recursos son compatibles y pueden estar en el grupo, consulte Tipos de recursos que puede usar con un AWS Resource Groups editor de etiquetas.

6. Elija Previsualizar recursos del grupo para devolver la lista de recursos de la pila de AWS CloudFormation que coincidan con los tipos de recursos que ha seleccionado.

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

8. Añada o elimine etiquetas en Etiquetas del grupo. 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 de 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.

9. Cuando haya terminado, elija Guardar cambios.

AWS CLI & AWS SDKs

En la AWS CLI, utilizará dos comandos diferentes para actualizar la consulta de un grupo y la descripción de un grupo de recursos. No se puede editar el nombre de un grupo existente. En la AWS CLI puede cambiar un grupo basado en etiquetas por un grupo basado en una pila de CloudFormation o viceversa.

1. Si no desea cambiar la descripción del grupo, omita este paso y continúe en el siguiente. Ejecute el siguiente comando, sustituyendo los valores de nombre de grupo y descripción por los suyos.

   $ 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-CFN-stack-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, ejecute el siguiente comando. Sustituya los valores del nombre del grupo, el identificador de la pila y los tipos de recursos por los suyos. Para añadir tipos de recursos, proporcione la lista completa de tipos de recursos en el comando, no solo los tipos de recursos que esté añadiendo. Puede incluir un máximo de 20 tipos de recursos en una consulta.

   El stack_identifier es el ARN de la pila, como se muestra en el comando de ejemplo.

   $ 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\"]}"}'

   El siguiente comando es un ejemplo.

   $ 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\"]}"}'

   El comando devuelve la consulta actualizada como resultado.