Crie um grupo baseado CloudFormation em pilhas

Os procedimentos a seguir mostram como criar uma consulta baseada em pilha 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. Em Criar grupo baseado em consulta, em Tipo de grupo, escolha o tipo de grupo baseado em CloudFormation pilha.

4. Escolha a pilha que você deseja usar como a base do grupo. Um grupo de recursos pode ser baseado em apenas uma pilha. Para filtrar a lista de pilhas, comece digitando o nome da pilha. Somente pilhas com status compatíveis são exibidas na lista.

5. Escolha os tipos de recurso na pilha que você deseja incluir no grupo. Para esta demonstração, mantenha o padrão, All supported resource types (Todos os tipos de recurso compatíveis). Para obter mais informações sobre quais tipos de recurso são compatíveis e podem estar no grupo, consulte Tipos de recursos que você pode usar com AWS Resource Groups o Tag Editor.

6. Escolha Exibir recursos do grupo para retornar a lista de recursos na CloudFormation pilha que correspondem aos tipos de recursos selecionados.

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 CloudFormation baseado em pilhas é baseado em uma consulta do tipo. CLOUDFORMATION_STACK_1_0

1. Execute o comando a seguir, substituindo os valores pelo nome do grupo e descrição, identificador de pilha e tipos de recurso de sua escolha. As descrições podem ter um máximo de 512 caracteres, incluindo letras, números, sublinhados, hifens, pontuação e espaços.

   Se você não especificar tipos de recurso, os Grupos de recursos incluirão todos os tipos de recurso compatíveis na pilha. 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.

   Esse stack_identifier é o ARN da pilha, conforme mostrado no comando de exemplo.

   $ aws resource-groups create-group \
       --name group_name \
       --description "description" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

   O comando a seguir é um exemplo.

   $ aws resource-groups create-group \
       --name My-CFN-stack-group \
       --description "My first CloudFormation stack-based group" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

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.