Aggiornamento dei gruppi in AWS Resource Groups

Per aggiornare un gruppo di risorse basato su tag in Resource Groups, puoi modificare la query e i tag che costituiscono la base del tuo gruppo. È possibile aggiungere e rimuovere le risorse dal gruppo solo apportando modifiche alla query o ai tag. Non è possibile selezionare risorse specifiche da aggiungere o rimuovere dal gruppo. Il modo migliore per aggiungere o rimuovere una risorsa specifica da un gruppo consiste nel modificare i tag della risorsa. Quindi verifica che la query relativa ai tag del gruppo di risorse includa o meno il tag, a seconda che tu voglia inserire la risorsa nel tuo gruppo.

Per aggiornare un gruppo di risorse AWS CloudFormation basato sullo stack, puoi scegliere uno stack diverso. Puoi anche aggiungere o rimuovere tipi di risorse dallo stack di cui desideri far parte del gruppo. Per modificare le risorse disponibili nello stack, laggiornare il modello AWS CloudFormation usato per creare lo stack, quindi aggiornare lo stack in AWS CloudFormation. Per ulteriori informazioni su come aggiornare uno AWS CloudFormation stack, consulta gli aggiornamenti AWS CloudFormation degli stack nella Guida per l'AWS CloudFormationutente.

In AWS CLI, è possibile aggiornare i gruppi mediante due comandi:

• update-group, che si esegue per aggiornare la descrizione di un gruppo.

• update-group-query, che si esegue per aggiornare la query e i tag delle risorse che determinano le risorse membri del gruppo.

Nella console, non è possibile modificare un gruppo AWS CloudFormation basato su stack in un gruppo di query basato su tag o viceversa. A questo scopo, utilizza l'API di Resource Groups, inclusa nellaAWS CLI.

Aggiornamento di gruppi di query basati su tag

Console

Aggiorna un gruppo basato su tag modificando i tipi di risorse o tag nella query su cui il gruppo si basa. È anche possibile aggiungere o modificare la descrizione del gruppo.

1. Accedi alla console AWS Resource Groups.

2. Nel riquadro di navigazione, in Resource Groups salvati, scegli il nome del gruppo, quindi scegli Modifica.

   Nota

   È possibile aggiornare esclusivamente i gruppi di risorse di proprietà dell'utente. La colonna Proprietario mostra la proprietà dell'account per ogni gruppo di risorse. Tutti i gruppi con un proprietario dell'account diverso da quello a cui hai effettuato l'accesso sono stati creatiAWS License Manager. Per ulteriori informazioni, consulta la sezione relativa ai gruppi di risorse AWS License Manager nella Guida per l'utente di License Manager.

3. Nella pagina Modifica gruppo, in Criteri di raggruppamento, aggiungi o rimuovi i tipi di risorse. È possibile avere un massimo di 20 tipi di risorse in una query. Per rimuovere un tipo di risorsa, scegli la X sull'etichetta del tipo di risorsa. Scegli View group resources (Visualizza risorse gruppo) per visualizzare l'effetto delle modifiche sui membri risorse del gruppo. In questo scenario, aggiungiamo il tipo di risorsa AWS::RDS::DBInstance alla query.

4. Sempre in Criteri di raggruppamento, modifica i tag secondo necessità. In questo esempio, filtriamo le risorse che hanno la chiave di tag Stage (Fase) e aggiungiamo il valore di tag Test. Il valore di tag è opzionale, ma restringe ulteriormente i risultati della query. Per rimuovere un tag, scegliere X sull’etichetta del tag.

5. Nell'area Additional information (Ulteriori informazioni), è possibile modificare la descrizione del gruppo. Non è possibile modificare il nome del gruppo dopo aver creato il gruppo.

6. (Facoltativo) In Tag di gruppo, puoi aggiungere o rimuovere i tag. I tag del gruppo sono metadati relativi al gruppo di risorse. Non incidono sulle risorse membro. Per modificare le risorse restituite dalla query del gruppo di risorse, modifica i tag che si trovano in Criteri di raggruppamento.

   I tag del gruppo sono utili se si prevede di rendere questo gruppo un membro di un gruppo più grande. È necessario specificare almeno una chiave di tag per creare un gruppo. Pertanto, assicurati di aggiungere almeno una chiave di tag nei tag di gruppo ai gruppi che prevedi di annidare in gruppi più grandi.

7. Scegli Anteprima delle risorse di gruppo per recuperare l'elenco aggiornato delle istanze EC2, dei bucket S3 e delle istanze del database Amazon RDS nel tuo account che corrispondono alle chiavi di tag specificate. Se le risorse non vengono visualizzare nell'elenco previsto, verificare che abbiano i tag specificati nell'area Grouping criteria (Criteri di raggruppamento).

8. Al termine, scegliere Save changes (Salva le modifiche).

AWS CLI & AWS SDKs

Nella AWS CLI, la query di un gruppo e la descrizione di un gruppo di risorse si aggiornano tramite due comandi diversi. Non è possibile modificare il nome di un gruppo esistente. NelAWS CLI, puoi cambiare un gruppo basato su tag in un gruppo basato su CloudFormation stack o viceversa.

1. Se non desideri modificare la descrizione del gruppo, salta questa fase e passa a quella successiva. In una sessione della AWS CLI, digitare quanto segue e premere Enter (Invio), sostituendo i valori del nome e della descrizione del gruppo con quelli desiderati.

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

   Il comando seguente è un esempio.

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

   Il comando restituisce una descrizione completa aggiornata del gruppo.

2. Per aggiornare la query e i tag di un gruppo, digitare il comando seguente. Sostituisci i valori per il nome del gruppo, i tipi di risorse, le chiavi dei tag e i valori dei tag con i tuoi. Quindi premere Invio. È possibile avere un massimo di 20 tipi di risorse in una query.

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

   Il comando seguente è un esempio.

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

   Il comando restituisce la query aggiornata.

Aggiorna un gruppo basato su AWS CloudFormation stack

Console

Non è possibile modificare un gruppo AWS CloudFormation basato su stack in un gruppo basato su tag in. AWS Management Console Tuttavia, è possibile modificare lo stack su cui si basa il gruppo o modificare i tipi di risorse dello stack che si desidera includere nel gruppo. È anche possibile aggiungere o modificare la descrizione del gruppo.

1. Accedi alla console AWS Resource Groups.

2. Nel riquadro di navigazione, in Gruppi di risorse salvati, scegli il nome del gruppo, quindi scegli Modifica.

3. Nota

   È possibile aggiornare esclusivamente i gruppi di risorse di proprietà dell'utente. La colonna Proprietario mostra la proprietà dell'account per ogni gruppo di risorse. Tutti i gruppi con un proprietario dell'account diverso da quello a cui hai effettuato l'accesso sono stati creatiAWS License Manager. Per ulteriori informazioni, consulta la sezione relativa ai gruppi di risorse AWS License Manager nella Guida per l'utente di License Manager.

4. Nella pagina Modifica gruppo, in Criteri di raggruppamento, per modificare lo stack su cui si basa il gruppo, scegli lo stack dall'elenco a discesa. Un gruppo di risorse può essere basato su un solo stack. Per filtrare l'elenco di stack, iniziare a digitare il nome dello stack. Solo gli stack con gli stati supportati sono riportati nell'elenco. Per un elenco di stati supportati, vedere Creazione di gruppi basati su interrogazioni inAWS Resource Groups in questa guida.

5. Aggiungere o rimuovere i tipi di risorse. Solo i tipi di risorse disponibili nello stack sono riportati nell'elenco a discesa. L'impostazione predefinita è All supported resource types (Tutti i tipi di risorse supportati). È possibile avere un massimo di 20 tipi di risorse in una query. Per rimuovere un tipo di risorsa, scegli la X sull'etichetta del tipo di risorsa. Per ulteriori informazioni su quali tipi di risorse sono supportati e possono essere presenti nel gruppo, vedere Tipi di risorse utilizzabili con AWS Resource Groups e Tag Editor.

6. Scegli Anteprima delle risorse del gruppo per recuperare l'elenco delle risorse nello AWS CloudFormation stack che corrispondono ai tipi di risorse selezionati.

7. Nell'area Additional information (Ulteriori informazioni), è possibile modificare la descrizione del gruppo. Non è possibile modificare il nome del gruppo dopo aver creato il gruppo.

8. In Group tags (Tag gruppo), aggiungere o rimuovere i tag. I tag del gruppo sono metadati relativi al gruppo di risorse. Non incidono sulle risorse membro. Per modificare le risorse restituite dalla query del gruppo di risorse, modificare i tag nell'area Grouping criteria (Criteri di raggruppamento).

   I tag del gruppo sono utili se si prevede di rendere questo gruppo un membro di un gruppo più grande. È necessario specificare almeno una chiave di tag per creare un gruppo. Pertanto, assicurati di aggiungere almeno una chiave di tag nei tag di gruppo ai gruppi che prevedi di annidare in gruppi più grandi.

9. Al termine, scegliere Save changes (Salva le modifiche).

AWS CLI & AWS SDKs

Nella AWS CLI, la query di un gruppo e la descrizione di un gruppo di risorse si aggiornano tramite due comandi diversi. Non è possibile modificare il nome di un gruppo esistente. NelAWS CLI, puoi cambiare un gruppo basato su tag in un gruppo basato su CloudFormation stack o viceversa.

1. Se non desideri modificare la descrizione del gruppo, salta questa fase e passa a quella successiva. Esegui il comando seguente, sostituendo i valori per il nome e la descrizione del gruppo con i tuoi.

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

   Il comando seguente è un esempio.

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

   Il comando restituisce una descrizione completa aggiornata del gruppo.

2. Per aggiornare la query e i tag di un gruppo, emettere il seguente comando. Sostituisci i valori per il nome del gruppo, l'identificatore dello stack e i tipi di risorse con i tuoi. Per aggiungere tipi di risorse, fornire l'elenco completo dei tipi di risorse nel comando, non solo i tipi di risorse che si stanno aggiungendo. È possibile avere un massimo di 20 tipi di risorse in una query.

   Lo stack_identifier è l’ARN dello stack, come mostrato nel comando di esempio.

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

   Il comando seguente è un esempio.

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

   Il comando restituisce la query aggiornata.