Atualizar grupos de consultas baseados em tags

Os procedimentos a seguir mostram como atualizar um grupo de consultas baseado em tags.

Console

Atualize um grupo baseado em tags alterando os tipos de recurso ou tags na consulta em que o grupo é baseado. Você também pode adicionar ou alterar a descrição do grupo.

1. Faça login no console do AWS Resource Groups.

2. No painel de navegação, em Grupos de recursos salvos, escolha um grupo e escolha Editar.

   nota

   Você pode atualizar apenas Grupos de recursos de sua propriedade. A coluna Proprietário mostra a propriedade da conta para cada grupo de recursos. Todos os grupos com um proprietário de conta diferente daquele em que você está conectado foram criados no AWS License Manager. Para obter mais informações, consulte Grupos de recursos de host no AWS License Manager no Guia do usuário do License Manager.

3. Na página Editar grupo, em Critérios de agrupamento, adicione ou remova tipos de recurso. Você pode ter no máximo 20 tipos de recurso em uma consulta. Para remover um tipo de recurso, escolha X no rótulo do tipo de recurso. Escolha View group resources (Visualizar recursos do grupo) para ver como as alterações afetam os membros de recursos do grupo. Neste passo a passo, adicionamos o tipo de recurso AWS: :RDS:: DBInstance à consulta.

4. Ainda em Critérios de agrupamento, edite as tags conforme necessário. Neste exemplo, filtramos recursos que têm uma chave de tag de Stage (Estágio) e adicionamos um valor de tag de Test (Teste). O valor da tag é opcional, mas restringe ainda mais os resultados da consulta. Para remover uma tag, escolha X no rótulo da tag.

5. Na área Additional information (Informações adicionais), você pode editar a descrição do grupo. Você não pode editar o nome de um grupo depois que o grupo foi criado.

6. (Opcional) Em Tags de grupo, você pode adicionar ou remover tags. As tags de grupos são metadados sobre seu grupo de recursos. Elas não afetam os recursos de membro. Para alterar os recursos que são retornados pela consulta do grupo de recursos, edite as tags em Critérios de agrupamento.

   As tags de grupo são úteis se você desejar que esse grupo faça parte de um grupo maior. É necessário especificar pelo menos uma chave de tag para criar um grupo. Portanto, adicione pelo menos uma chave de tag em Tags de grupo aos grupos que você planeja aninhar em grupos maiores.

7. Escolha os recursos do grupo Preview para recuperar a lista atualizada de EC2 instâncias, buckets S3 e instâncias de banco de dados do Amazon RDS em sua conta que correspondem às chaves de tag especificadas. Se você não vir os recursos que esperava na lista, certifique-se de que os recursos estejam marcados com as tags que você especificou na área Grouping criteria (Critérios de agrupamento).

8. Ao concluir, escolha Save changes.

AWS CLI & AWS SDKs

No AWS CLI, você atualiza a consulta de um grupo e atualiza a descrição de um grupo de recursos usando dois comandos diferentes. Não é possível editar o nome de um grupo existente. No AWS CLI, você pode alterar um grupo baseado em tags para um grupo baseado CloudFormation em pilhas ou vice-versa.

1. Se não desejar alterar a descrição do grupo, ignore esta etapa e vá para a próxima. Em uma AWS CLI sessão, digite o seguinte e pressione Enter, substituindo os valores do nome e da descrição do grupo pelos seus.

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

   O comando a seguir é um exemplo.

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

   O comando retorna uma descrição completa e atualizada do grupo.

2. Para atualizar a consulta e as tags de um grupo, digite o comando a seguir. Substitua os valores de nome do grupo, tipos de recursos, chaves de tag e valores de tag por valores de sua escolha. Em seguida, pressione Enter. Você pode ter no máximo 20 tipos de recurso em uma 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\"]}]}"}'

   O comando a seguir é um exemplo.

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

   O comando retorna a consulta atualizada como resultado.