Atualizar um grupo baseado AWS CloudFormation em pilhas

Os procedimentos a seguir mostram como atualizar um grupo CloudFormation baseado em pilhas.

Console

Você não pode alterar um grupo AWS CloudFormation baseado em pilha para um grupo baseado em tags no. AWS Management Console No entanto, você pode alterar a pilha na qual o grupo é baseado, ou alterar tipos de recurso da pilha que você deseja incluir no grupo. 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 o nome do grupo e escolha Editar.

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

4. Na página Editar grupo, em Critérios de agrupamento, para alterar a pilha em que o grupo é baseado, escolha a pilha na lista suspensa. 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. Para obter uma lista de status compatíveis, consulte Criação de grupos baseados em consultas no AWS Resource Groups neste guia.

5. Adicione ou remova tipos de recurso. Somente tipos de recurso que estão disponíveis na pilha são mostrados na lista suspensa. O padrão é All supported resource types (Todos os tipos de recurso compatíveis). 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. 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 Visualizar recursos do grupo para recuperar a lista de recursos na AWS CloudFormation pilha que correspondem aos tipos de recursos selecionados.

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

8. Em Group tags (Tags do grupo), adicione ou remova 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 na área Grouping criteria (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.

9. 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. Execute o comando a seguir, substituindo os valores pelo nome do grupo e descrição de sua escolha.

   $ 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-CFN-stack-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, execute o seguinte comando. Substitua os valores do nome do grupo, identificador da pilha e tipos de recursos de sua escolha. Para adicionar tipos de recurso, forneça a lista completa dos tipos de recurso no comando, não apenas os tipos de recurso que você está adicionando. Você pode ter no máximo 20 tipos de recurso em uma consulta.

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

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

   O comando a seguir é um exemplo.

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

   O comando retorna a consulta atualizada como resultado.