

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

# Esempi di query di ricerca in Resource Explorer
<a name="using-search-query-examples"></a>

Gli esempi seguenti mostrano la sintassi per i tipi più comuni di interrogazioni che è possibile utilizzare inEsploratore di risorse AWS.

**Importante**  
Se si utilizza ilAWS CLI`search` comando e il valore del`--query-string` parametro ha l'`-`operatore come primo carattere, è necessario separare il nome del parametro dal suo valore con un carattere di segno uguale (`=`) anziché il normale carattere di spazio. Se si utilizza lo spazio, la CLI interpreta erroneamente la stringa. Ad esempio, la seguente query ha esito negativo.  

```
aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"
```
La seguente query corretta, con una`=` sostituzione dello spazio, funziona come previsto.  

```
aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"
```
Se modificate l'ordine dei filtri nella stringa di ricerca in modo che`-` non sia il primo carattere nel valore del parametro, potete usare lo spazio standard. La seguente query funziona.  

```
aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
```

## Cerca risorse senza tag
<a name="example-1"></a>

Se desideri utilizzare il [controllo degli accessi basato sugli attributi (ABAC)](https://aws.amazon.com/identity/attribute-based-access-control/) nel tuo account, utilizzare l'[allocazione basata sui costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) o eseguire l'automazione basata su tag sulle tue risorse, devi sapere a quali risorse del tuo account potrebbero mancare i tag. La seguente query di esempio utilizza lo speciale [tag case filter: none](using-search-query-syntax.md#query-syntax-filters) per restituire tutte le risorse a cui mancano i tag generati dall'utente.

Il`tag:none` filtro si applica solo ai tag *creati dall'utente*. I tag generati e gestiti daAWS sono esenti da questo filtro e vengono comunque visualizzati nei risultati.

```
tag:none
```

Inoltre, per escludere tutti i tag di sistemaAWS creati, aggiungi un secondo filtro come mostrato nell'esempio seguente. Il primo elemento nella stringa di query duplica l'esempio precedente filtrando tutti i tag creati dall'utente. AWSi tag di sistema creati iniziano *sempre* con le lettere`aws`. Pertanto, è possibile utilizzare l'[operatore logico NOT (-)](using-search-query-syntax.md#query-syntax-operators) con il [filtro tag.key](using-search-query-syntax.md#query-syntax-filters) per escludere anche tutte le risorse che hanno un tag con un nome chiave che inizia con`aws`.

```
tag:none -tag.key:aws*
```

## Cerca risorse contrassegnate
<a name="example-2"></a>

Per trovare tutte le risorse che hanno un tag di qualsiasi tipo, puoi usare l'[operatore logico NOT (-)](using-search-query-syntax.md#query-syntax-operators) con il filtro speciale case [tag: none](using-search-query-syntax.md#query-syntax-filters) come segue.

```
-tag:none
```

## Cerca risorse a cui manca un tag specifico
<a name="example-3"></a>

Inoltre, in relazione all'ABAC, potresti voler cercare tutte le risorse che non hanno un tag con una chiave specificata. L'esempio seguente utilizza l'[operatore logico NOT`-`](using-search-query-syntax.md#query-syntax-operators) per restituire tutte le risorse a cui manca un tag con il nome della chiave`Department`.

```
-tag.key:Department
```

## Cerca risorse con valori di tag non validi
<a name="example-4"></a>

Per motivi di conformità, potresti voler cercare tutte le risorse con valori di tag mancanti o scritti in modo errato su tag importanti. L'esempio seguente restituisce tutte le risorse che hanno un tag con il nome della chiave`environment`. Tuttavia, la query filtra qualsiasi risorsa con uno dei valori validi`prod``integ`, o`dev`. Tutti i risultati che appaiono da questa query hanno un altro valore che è necessario esaminare e correggere.

**Importante**  
Le ricerche in Resource Explorer ***non*** fanno distinzione tra maiuscole e minuscole e non possono distinguere tra nomi di chiavi e valori che differiscono solo per il modo in cui sono scritti in maiuscolo. Ad esempio, i valori nell'esempio seguente corrispondono a`PROD``prod`,`PrOd`, o a qualsiasi variazione. Tuttavia, alcune applicazioni utilizzano i tag facendo distinzione tra maiuscole e minuscole. Ti consigliamo di adottare una strategia di capitalizzazione standardizzata per la tua organizzazione, ad esempio utilizzando solo i nomi e i valori delle chiavi dei tag minuscoli. Un approccio coerente può aiutare a evitare la confusione che può essere causata dalla presenza di tag che differiscono solo dal modo in cui sono scritti in maiuscolo.

```
tag.key:environment -tag:environment=prod -tag:environment=integ -tag:environment=dev
```

## Cerca risorse in un sottoinsieme diRegioni AWS
<a name="example-5"></a>

Usa l'[operatore`'*'` jolly](using-search-query-syntax.md#query-syntax-operators) per abbinare tutte le regioni in una determinata area del mondo. L'esempio seguente restituisce tutte le risorse presenti in Regioni d'Europa (UE).

```
region:eu-*
```

## Cerca risorse globali
<a name="example-6"></a>

Usa il`global` valore speciale del`region:` filtro per trovare le tue risorse considerate globali e non associate a una singola regione.

```
region:global
```

## Cerca risorse di un determinato tipo che si trovano in una regione specifica
<a name="example-7"></a>

Quando si utilizzano più filtri, Resource Explorer valuta l'espressione combinando i prefissi con`AND` operatori logici impliciti. L'esempio seguente restituisce tutte le risorse che si trovano nella regione Asia Pacifico (Hong Kong)`AND` sono istanze Amazon EC2.

```
region:ap-east-1 resourcetype:ec2:instance
```

**Nota**  
A causa dell'implicito`AND`, è possibile utilizzare correttamente un solo filtro per un attributo che può avere un solo valore associato alla risorsa. Ad esempio, una risorsa può far parte di una sola risorsaRegione AWS. Pertanto, la seguente query non restituisce risultati.  

```
region:us-east-1 region:us-west-1
```
Questa limitazione ***non*** si applica ai filtri per gli attributi che possono avere più valori contemporaneamente, ad esempio`tag:``tag.key:`, e`tag.value:`.

## Cerca risorse con un termine composto da più parole
<a name="example-8"></a>

Racchiudi un termine composto da più parole con [virgolette doppie (`"`)](using-search-query-syntax.md#query-syntax-operators) per restituire solo i risultati che hanno l'intero termine nell'ordine specificato. Senza virgolette doppie, Resource Explorer restituisce risorse che corrispondono a qualsiasi singola parola che compone il termine. Ad esempio, la seguente query utilizza le virgolette doppie per restituire solo le risorse che corrispondono al termine`"west wing"`. La query ***non*** corrisponde alle risorse della`us-west-2`Regione AWS (o di qualsiasi altra regione inclusa`west` nel suo codice) o alle risorse che corrispondono alla parola «ala» senza la parola «ovest».

```
"west wing"
```

## Cerca le risorse che fanno parte di uno CloudFormation stack specificato
<a name="example-9"></a>

Quando crei una risorsa come parte di unoCloudFormation stack, tutte vengono *automaticamente* etichettate con il nome dello stack. L'esempio seguente restituisce tutte le risorse create come parte dello stack specificato.

```
tag:aws:cloudformation:stack-name=my-stack-name
```