Criar uma consulta baseada em tag e criar um grupo

Os procedimentos a seguir mostram como criar uma consulta baseada em tag e usar isso para criar um grupo de recursos.

Console

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

2. No painel de navegação, selecione Criar grupo de recursos.

3. Na página Criar grupo baseado em consulta, em Tipo de grupo, escolha o tipo de grupo Baseado em tags.

4. Em Critérios de agrupamento, escolha os tipos de recurso que você deseja incluir no grupo de recursos. Você pode ter no máximo 20 tipos de recurso em uma consulta. Para este passo a passo, escolha e. AWS::EC2::InstanceAWS::S3::Bucket

5. Ainda em Critérios de agrupamento, para Tags, especifique uma chave de tag, ou um par de chave e valor de tag, a fim de limitar os recursos correspondentes para incluir somente aqueles que estão marcados com seus valores especificados. Escolha Adicionar ou pressione Enter quando tiver concluído a tag. Neste exemplo, filtramos os recursos que têm uma chave de tag Stage (Estágio). O valor da tag é opcional, mas restringe ainda mais os resultados da consulta. Você pode adicionar vários valores para uma chave de tag adicionando um operador OR entre os valores de tag. Para adicionar mais tags, escolha Adicionar. As consultas atribuem um operador AND às tags, de forma que qualquer recurso que corresponda aos tipos de recurso especificados e todas as tags especificadas seja retornado pela consulta.

6. Ainda em Critérios de agrupamento, escolha Visualizar recursos do grupo para retornar a lista de EC2 instâncias e buckets do S3 em sua conta que correspondem à chave ou chaves de tag especificadas.

7. Depois de obter os resultados desejados, crie um grupo com base nessa consulta.

   1. Na página Detalhes do grupo, digite um nome para seu grupo de recursos em Nome do grupo.

      Um nome de grupo de recursos pode ter no máximo 128 caracteres, incluindo letras, números, pontos, hifens e sublinhados. O nome não pode iniciar com AWS ou aws. Esses são reservados. Um nome de grupo de recursos deve ser exclusivo na região atual em sua conta.

   2. (Opcional) Em Group description (Descrição do grupo), digite uma descrição para o grupo.

   3. (Opcional) Na área Group tags (Tags do grupo), adicione pares de chave e valor de tags que se aplicam somente ao grupo de recursos, e não a recursos de membro no grupo.

      As tags de grupo são úteis se você desejar que esse grupo faça parte de um grupo maior. Como é necessário especificar pelo menos uma chave de tag para criar um grupo, certifique-se de adicionar pelo menos uma chave de tag em Group tags (Tags do grupo) nos grupos que você pretende aninhar em grupos maiores.

8. Ao concluir, escolha Criar grupo.

AWS CLI & AWS SDKs

Um grupo baseado em tag é baseado em uma consulta do tipo TAG_FILTERS_1_0.

1. Em uma AWS CLI sessão, digite o seguinte e pressione Enter, substituindo os valores de nome do grupo, descrição, tipos de recursos, chaves de tag e valores de tag pelos seus próprios. As descrições podem ter um máximo de 512 caracteres, incluindo letras, números, sublinhados, hifens, pontuação e espaços. Você pode ter no máximo 20 tipos de recurso em uma consulta. Um nome de grupo de recursos pode ter no máximo 128 caracteres, incluindo letras, números, pontos, hifens e sublinhados. O nome não pode iniciar com AWS ou aws. Esses são reservados. Um nome de grupo de recursos deve ser exclusivo em sua conta.

   Pelo menos um valor para ResourceTypeFilters é necessário. Para especificar todos os tipos de recurso, use AWS::AllSupported como o 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\"]}]}"}'

   O comando a seguir é um exemplo.

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

   O comando a seguir é um exemplo que inclui todos os tipos de recurso compatíveis.

   $ 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. Veja a seguir o que é retornado na resposta ao comando.

   • Uma descrição completa do grupo que você criou.

   • A consulta de recursos que você usou para criar o grupo.

   • As tags associadas ao grupo.