Actualice un grupo AWS CloudFormation basado en pilas

Los siguientes procedimientos muestran cómo actualizar un grupo basado en CloudFormation pilas.

Console

No puede cambiar un grupo basado en AWS CloudFormation pilas a un grupo basado en etiquetas en. 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 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 en AWS 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. Seleccione Vista previa de los recursos del grupo para recuperar la lista de recursos de la AWS CloudFormation pila que coinciden con los tipos de recursos seleccionados.

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 finalizado, 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. 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.

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