Construir una consulta basada en etiquetas y crear un grupo

Los siguientes procedimientos le muestran cómo crear una consulta basada en etiquetas y usarla para crear un grupo de recursos.

Console

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

2. En el panel de navegación, elija Crear Resource Group.

3. En la páginaCrear grupo basado en consultas, en Tipo de grupo, elija el tipo de grupo Basado en etiquetas.

4. En Criterios de agrupación, elija los tipos de recursos que desea que formen parte del grupo de recursos. Puede incluir un máximo de 20 tipos de recursos en una consulta. Para este tutorial, elija AWS::EC2::Instancey. AWS::S3::Bucket

5. Aun en Criterios de agrupación, para las Etiquetas, especifique una clave de etiqueta o un par de clave y valor para limitar los recursos coincidentes e incluir solo aquellos que estén etiquetados con los valores especificados. Elija Añadir o pulse Intro cuando haya terminado de definir la etiqueta. En este ejemplo, filtre los recursos que tienen una clave de etiqueta Etapa. El valor de la etiqueta es opcional, pero permite limitar aún más los resultados de la consulta. Puede añadir varios valores a una clave de etiqueta añadiendo un operador OR entre los valores de las etiquetas. Para añadir más etiquetas, elija Añadir. Las consultas asignan un operador AND a las etiquetas, por lo que devolverán los recursos que coincidan con los tipos de recursos especificados y con todas las etiquetas especificadas.

6. Aún en Criterios de agrupación, selecciona Vista previa de los recursos del grupo para obtener la lista de EC2 instancias y depósitos de S3 de tu cuenta que coinciden con la clave o claves de etiqueta especificadas.

7. Una vez que tenga los resultados que desea, cree un grupo basado en esta consulta.

   1. En la página Detalles del grupo, en Nombre de grupo, escriba un nombre para el grupo de recursos.

      El nombre de un grupo de recursos puede tener un máximo de 128 caracteres de longitud e incluir letras, números, guiones, puntos y guiones bajos. El nombre no puede comenzar por AWS ni aws. Estas cadenas están reservadas. El nombre de un grupo de recursos debe ser único en la región actual de la cuenta.

   2. (Opcional) En Descripción del grupo, escriba una descripción para el grupo.

   3. (Opcional) En Etiquetas del grupo, añada pares de clave y valor de etiqueta que se aplicarán solamente al grupo de recursos, no a los recursos miembros del grupo.

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

8. Cuando termine, elija Crear grupo.

AWS CLI & AWS SDKs

Un grupo basado en etiquetas se basa en una consulta de tipo TAG_FILTERS_1_0.

1. En una AWS CLI sesión, escribe lo siguiente y, a continuación, presiona Entrar y reemplaza los valores del nombre del grupo, la descripción, los tipos de recursos, las claves y los valores de las etiquetas por los tuyos. Las descripciones pueden tener un máximo de 512 caracteres de longitud e incluir letras, números, guiones, guiones bajos, puntuación y espacios. Puede incluir un máximo de 20 tipos de recursos en una consulta. El nombre de un grupo de recursos puede tener un máximo de 128 caracteres de longitud e incluir letras, números, guiones, puntos y guiones bajos. El nombre no puede comenzar por AWS ni aws. Estas cadenas están reservadas. El nombre de un grupo de recursos debe ser único en la cuenta.

   Al menos es obligatorio un valor para ResourceTypeFilters. Para especificar todos los tipos de recursos, utiliceAWS::AllSupported como el valor de ResourceTypeFilters.

   $ aws resource-groups create-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 create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   El siguiente comando es un ejemplo que incluye todos los tipos de recursos admitidos.

   $ aws resource-groups create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

2. El comando devuelve lo siguiente.

   • Una descripción completa del grupo que se ha creado.

   • La consulta de recursos que ha utilizado para crear el grupo.

   • Las etiquetas que están asociadas al grupo.