Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creazione di gruppi basati su query in AWS Resource Groups
## Tipi di interrogazioni relative ai gruppi di risorse
In AWS Resource Groups, una *query* è la base di un gruppo basato su query. È possibile basare un gruppo di risorse su uno dei due tipi di query.
**Tag-based (Basato su tag)**
Le interrogazioni basate su tag includono elenchi di tipi di risorse specificati nel formato `AWS::service::resource` seguente e tag. I *Tags (tag)* sono chiavi che consentono di identificare e ordinare le risorse all'interno della propria organizzazione. I tag possono includere valori per le chiavi.
Per una query basata su tag, è anche possibile specificare i tag condivisi dalle risorse che si desidera siano membri del gruppo. Ad esempio, se desideri creare un gruppo di risorse con tutte le istanze Amazon EC2 e i bucket Amazon S3 che utilizzi per eseguire la fase di test di un'applicazione e disponi di istanze e bucket etichettati in questo modo, scegli i tipi di `AWS::S3::Bucket` risorse `AWS::EC2::Instance` e dall'elenco a discesa, quindi specifica la chiave del tag, con un valore di tag di. **Stage** **Test**
La sintassi del `ResourceQuery` parametro di un gruppo di risorse basato su tag contiene i seguenti elementi:
+ `Type`
Questo elemento indica il tipo di interrogazione che definisce questo gruppo di risorse. Per creare un gruppo di risorse basato su tag, specificate il valore `TAG_FILTERS_1_0` nel modo seguente:
```
"Type": "TAG_FILTERS_1_0"
```
+ `Query`
Questo elemento definisce l'interrogazione effettiva utilizzata per il confronto con le risorse. Contiene una rappresentazione in formato stringa di una struttura JSON con i seguenti elementi:
+ `ResourceTypeFilters`
Questo elemento limita i risultati solo ai tipi di risorse che corrispondono al filtro. Puoi specificare le seguenti valori:
+ `"AWS::AllSupported"`— specificare che i risultati possono includere risorse di qualsiasi tipo che corrispondono alla query e che sono attualmente supportate dal servizio Resource Groups.
+ `"AWS::service-id::resource-type`— un elenco separato da virgole di stringhe di specifiche del tipo di risorsa con questo formato:, ad esempio. `"AWS::EC2::Instance"`
+ `TagFilters`
Questo elemento specifica le coppie di key/value stringhe che vengono confrontate con i tag allegati alle risorse. Quelli con una chiave di tag e un valore che corrispondono al filtro sono inclusi nel gruppo. Ogni filtro è composto dai seguenti elementi:
+ `"Key"`— una stringa con un nome chiave. Solo le risorse con tag con un nome chiave corrispondente corrispondono al filtro e sono membri del gruppo.
+ `"Values"`— una stringa con un elenco di valori separati da virgole per la chiave specificata. Solo le risorse con una chiave di tag corrispondente e un valore che corrisponde a uno in questo elenco sono membri del gruppo.
Tutti questi elementi JSON devono essere combinati in una rappresentazione a riga singola della struttura JSON. Ad esempio, si consideri una struttura `Query` JSON con il seguente esempio. Questa query è pensata per corrispondere solo alle istanze Amazon EC2 che hanno un tag «Stage» con un valore «Test».
```
{
"ResourceTypeFilters": [ "AWS::EC2::Instance" ],
"TagFilters": [
{
"Key": "Stage",
"Values": [ "Test" ]
}
]
}
```
Tale codice JSON può essere rappresentato come la seguente stringa a riga singola e utilizzato come valore dell'elemento. `Query` Poiché il valore di una struttura JSON deve essere una stringa tra virgolette doppie, è necessario evitare le virgolette o i caratteri barra incorporati facendo precedere ciascuno di essi da una barra rovesciata, come illustrato di seguito:
```
"Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"
```
La `ResourceQuery` stringa completa viene quindi rappresentata come mostrato qui, come parametro del comando CLI:
```
--resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'
```
**CloudFormation basato su stack**
In una query CloudFormation basata sullo stack, scegli uno CloudFormation stack nel tuo account nell'area corrente, quindi scegli i tipi di risorse nello stack che desideri inserire nel gruppo. È possibile basare la query su un solo stack. CloudFormation
Uno CloudFormation stack può contenere altri stack CloudFormation «secondari». Tuttavia, un gruppo di risorse basato su uno stack «principale» non ottiene tutte le risorse degli stack secondari come membri del gruppo. I gruppi di risorse aggiungono gli stack secondari al gruppo di risorse dello stack principale come membri singoli del gruppo e non li espandono.
Resource Groups supporta le query basate su CloudFormation stack con uno dei seguenti stati.
+ `CREATE_COMPLETE`
+ `CREATE_IN_PROGRESS`
+ `DELETE_FAILED`
+ `DELETE_IN_PROGRESS`
+ `REVIEW_IN_PROGRESS`
Solo le risorse create direttamente come parte dello stack della query sono incluse nel gruppo di risorse. Le risorse create successivamente dai membri dello CloudFormation stack non diventano membri del gruppo. ***Ad esempio, se un gruppo con scalabilità automatica viene creato CloudFormation da come parte dello stack, quel gruppo con scalabilità automatica è un membro del gruppo.*** Tuttavia, un'istanza Amazon EC2 creata da quel gruppo di auto-scaling come parte del suo funzionamento ***non fa parte del gruppo di risorse basato*** sullo stack. CloudFormation
Se crei un gruppo basato su uno CloudFormation stack e lo stato dello stack cambia in uno che non è più supportato come base per una query di gruppo, ad esempio, il gruppo di risorse esiste ancora`DELETE_COMPLETE`, ma non ha risorse membri.
Dopo aver creato un gruppo di risorse, è possibile eseguire attività sulle risorse del gruppo.
La sintassi del `ResourceQuery` parametro di un gruppo di risorse CloudFormation basato sullo stack contiene i seguenti elementi:
+ `Type`
Questo elemento indica il tipo di interrogazione che definisce questo gruppo di risorse.
Per creare un gruppo di risorse CloudFormation basato sullo stack, specificate il valore nel modo `CLOUDFORMATION_STACK_1_0` seguente:
```
"Type": "CLOUDFORMATION_STACK_1_0"
```
+ `Query`
Questo elemento definisce l'interrogazione effettiva utilizzata per il confronto con le risorse. Contiene una rappresentazione in formato stringa di una struttura JSON con i seguenti elementi:
+ `ResourceTypeFilters`
Questo elemento limita i risultati solo ai tipi di risorse che corrispondono al filtro. Puoi specificare le seguenti valori:
+ `"AWS::AllSupported"`— per specificare che i risultati possono includere risorse di qualsiasi tipo che corrispondono alla query.
+ `"AWS::service-id::resource-type`— un elenco separato da virgole di stringhe di specificazione del tipo di risorsa con questo formato:, ad esempio. `"AWS::EC2::Instance"`
+ `StackIdentifier`
Questo elemento specifica l'Amazon Resource Name (ARN) CloudFormation dello stack di cui desideri includere le risorse nel gruppo.
Tutti questi elementi JSON devono essere combinati in una rappresentazione a riga singola della struttura JSON. Ad esempio, si consideri una struttura `Query` JSON con il seguente esempio. Questa query è pensata per corrispondere solo ai bucket Amazon S3 che fanno parte dello stack specificato. CloudFormation
```
{
"ResourceTypeFilters": [ "AWS::S3::Bucket" ],
"StackIdentifier": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyCloudFormationStackName/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE"
}
```
Tale codice JSON può essere rappresentato come la seguente stringa a riga singola e utilizzato come valore dell'elemento. `Query` Poiché il valore di una struttura JSON deve essere una stringa tra virgolette doppie, è necessario evitare le virgolette o i caratteri barra incorporati facendo precedere ciascuno di essi da una barra rovesciata, come illustrato di seguito:
```
"Query":"{\"ResourceTypeFilters\":[\"AWS::S3::Bucket\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/MyCloudFormationStackName\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\"
```
La `ResourceQuery` stringa completa viene quindi rappresentata come mostrato qui, come parametro del comando CLI:
```
--resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::S3::Bucket\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/MyCloudFormationStackName\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\"}'
```
# Crea una query basata su tag e crea un gruppo
Le procedure seguenti mostrano come creare una query basata su tag e utilizzarla per creare un gruppo di risorse.
------
#### [ Console ]
1. Accedi alla [console AWS Resource Groups](https://console.aws.amazon.com/resource-groups).
1. Nel riquadro di navigazione, scegli **[Crea gruppo di risorse](https://console.aws.amazon.com/resource-groups/groups/new)**.
1. Nella pagina **Crea gruppo basato su query**, in Tipo di **gruppo, scegli il tipo di** gruppo **basato su tag**.
1. In **Criteri di raggruppamento**, scegli i tipi di risorse che desideri includere nel tuo gruppo di risorse. È possibile avere un massimo di 20 tipi di risorse in una query. Per questa procedura dettagliata, scegli e. **AWS::EC2::Instance**AWS::S3::Bucket****
1. Sempre in **Criteri di raggruppamento**, per i **tag**, specifica una chiave di tag o una coppia chiave-valore del tag, per limitare le risorse corrispondenti in modo da includere solo quelle contrassegnate con i valori specificati. Scegliere **Add (Aggiungi)** o premere **Invio** al completamento del tag. In questo esempio, vengono filtrate le risorse con la chiave di tag di **Stage (Fase)**. Il valore di tag è opzionale, ma restringe ulteriormente i risultati della query. È possibile aggiungere più valori per una chiave di tag aggiungendo un `OR` operatore tra i valori dei tag. Per aggiungere ulteriori tag, scegliere **Add (Aggiungi)**. Le query assegnano un operatore `AND` ai tag in modo da restituire le risorse che corrispondono ai tipi di risorsa specificati e a tutti i tag specificati.
1. Sempre in **Criteri di raggruppamento**, scegli **Anteprima delle risorse del gruppo** per visualizzare l'elenco delle istanze EC2 e dei bucket S3 presenti nel tuo account che corrispondono alla chiave o alle chiavi di tag specificate.
1. Dopo aver ottenuto i risultati desiderati, crea un gruppo basato su questa query.
1. In **Dettagli del gruppo**, in **Nome del gruppo**, digita un nome per il tuo gruppo di risorse.
Il nome di un gruppo di risorse può avere un massimo di 128 caratteri, inclusi lettere, numeri, trattini, punti e trattini bassi. Il nome non può iniziare per `AWS` o `aws`, poiché sono riservati. Il nome di un gruppo di risorse deve essere univoco nella regione corrente del tuo account.
1. (Facoltativo) In **Group description (Descrizione gruppo)**, immettere una descrizione del tuo gruppo.
1. (Facoltativo) Nell'area **Group tags (Tag gruppo)**, aggiungere una chiave di tag e coppie di valore che si applicano solo al gruppo di risorse, non alle risorse membri del gruppo.
I tag del gruppo sono utili se si prevede di rendere questo gruppo un membro di un gruppo più grande. Poiché è necessario specificare almeno una chiave di tag per creare un gruppo, assicurarsi di aggiungere almeno una chiave di tag in **Group tags (Tag gruppo)** ai gruppi che si prevede di annidare in gruppi più grandi.
1. Quando hai finito, scegli **Crea gruppo**.
------
#### [ AWS CLI & AWS SDKs ]
Un gruppo basato su tag si basa su un tipo di query `TAG_FILTERS_1_0`.
1. In una AWS CLI sessione, digita quanto segue, quindi premi **Invio**, sostituendo i valori per il nome del gruppo, la descrizione, i tipi di risorse, le chiavi dei tag e i valori dei tag con i tuoi. Le descrizioni possono avere un massimo di 512 caratteri, inclusi lettere, numeri, trattini, trattini bassi, punteggiatura e spazi. È possibile avere un massimo di 20 tipi di risorse in una query. Il nome di un gruppo di risorse può avere un massimo di 128 caratteri, inclusi lettere, numeri, trattini, punti e trattini bassi. Il nome non può iniziare per `AWS` o `aws`, poiché sono riservati. Il nome di un gruppo di risorse deve essere univoco nell'account.
Almeno un valore per `ResourceTypeFilters` è obbligatorio. Per specificare tutti i tipi di risorse, utilizzare `AWS::AllSupported` come valore di `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\"]}]}"}'
```
Il comando seguente è un esempio.
```
$ 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\"]}]}"}'
```
Il comando seguente è un esempio che include tutti i tipi di risorse supportati.
```
$ 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\"]}]}"}'
```
1. I seguenti risultati vengono restituiti in risposta al comando.
+ Una descrizione completa del gruppo creato.
+ La query delle risorse utilizzata per creare il gruppo.
+ I tag associati al gruppo.
------
# Crea un gruppo basato su CloudFormation stack
Le procedure seguenti mostrano come creare una query basata sullo stack e utilizzarla per creare un gruppo di risorse.
------
#### [ Console ]
1. Accedi alla [console AWS Resource Groups](https://console.aws.amazon.com/resource-groups).
1. Nel riquadro di navigazione, scegli **[Crea gruppo di risorse](https://console.aws.amazon.com/resource-groups/groups/new)**.
1. In **Crea gruppo basato su query**, in Tipo di **gruppo, scegli il tipo di gruppo** **basato sullo CloudFormation stack**.
1. Scegli lo stack che si desidera sia alla base del gruppo. 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.
1. Scegliere i tipi di risorse nello stack che si desidera includere nel gruppo. Per questo scenario, mantenere l'impostazione predefinita, **All supported resource types (Tutti i tipi di risorse supportati)**. 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](supported-resources.md).
1. Scegli **Visualizza le risorse del gruppo** per visualizzare l'elenco delle risorse nello CloudFormation stack che corrispondono ai tipi di risorse selezionati.
1. Dopo aver ottenuto i risultati desiderati, crea un gruppo basato su questa query.
1. In **Dettagli del gruppo**, in **Nome del gruppo**, digita un nome per il tuo gruppo di risorse.
Il nome di un gruppo di risorse può avere un massimo di 128 caratteri, inclusi lettere, numeri, trattini, punti e trattini bassi. Il nome non può iniziare per `AWS` o `aws`, poiché sono riservati. Il nome di un gruppo di risorse deve essere univoco nella regione corrente del tuo account.
1. (Facoltativo) In **Group description (Descrizione gruppo)**, immettere una descrizione del tuo gruppo.
1. (Facoltativo) Nell'area **Group tags (Tag gruppo)**, aggiungere una chiave di tag e coppie di valore che si applicano solo al gruppo di risorse, non alle risorse membri del gruppo.
I tag del gruppo sono utili se si prevede di rendere questo gruppo un membro di un gruppo più grande. Poiché è necessario specificare almeno una chiave di tag per creare un gruppo, assicurarsi di aggiungere almeno una chiave di tag in **Group tags (Tag gruppo)** ai gruppi che si prevede di annidare in gruppi più grandi.
1. Quando hai finito, scegli **Crea gruppo**.
------
#### [ AWS CLI & AWS SDKs ]
Un gruppo CloudFormation basato sullo stack si basa su una query di tipo. `CLOUDFORMATION_STACK_1_0`
1. Esegui il comando seguente, sostituendo i valori per il nome del gruppo, la descrizione, l'identificatore dello stack e i tipi di risorse con i tuoi. Le descrizioni possono avere un massimo di 512 caratteri, inclusi lettere, numeri, trattini, trattini bassi, punteggiatura e spazi.
Se non si specificano i tipi di risorse, Resource Groups include tutti i tipi di risorse supportati nello stack. È possibile avere un massimo di 20 tipi di risorse in una query. Il nome di un gruppo di risorse può avere un massimo di 128 caratteri, inclusi lettere, numeri, trattini, punti e trattini bassi. Il nome non può iniziare per `AWS` o `aws`, poiché sono riservati. Il nome di un gruppo di risorse deve essere univoco nell'account.
*stack\$1identifier*È l'ARN dello stack, come mostrato nel comando di esempio.
```
$ 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\"]}"}'
```
Il comando seguente è un esempio.
```
$ 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\"]}"}'
```
1. I seguenti risultati vengono restituiti in risposta al comando.
+ Una descrizione completa del gruppo creato.
+ La query delle risorse utilizzata per creare il gruppo.
------