Riferimento alla sintassi delle query di ricerca per Resource Explorer

Esploratore di risorse AWS ti aiuta a trovare AWS risorse individuali nel tuo Account AWS. Per aiutarti a trovare esattamente le risorse che stai cercando, Resource Explorer accetta stringhe di query di ricerca che supportano la sintassi descritta in questo argomento. Per le query ad esempio che dimostrano come utilizzare le funzionalità descritte qui, vedi. Esempi di query di ricerca in Resource Explorer

Nota

Al momento, i tag allegati alle risorse AWS Identity and Access Management (IAM), come ruoli o utenti, non sono indicizzati.

Come funzionano le interrogazioni in Resource Explorer

Le query di ricerca utilizzano sempre una visualizzazione. Se non ne specifichi una in modo esplicito, Resource Explorer utilizza la visualizzazione designata come predefinita per Regione AWS quella in cui stai lavorando.

Le visualizzazioni determinano quali risorse sono disponibili per le interrogazioni. È possibile creare viste diverse, ognuna delle quali restituisce un set diverso di risorse.

Ad esempio, è possibile creare una visualizzazione che includa solo le risorse contrassegnate con la chiave Environment e il valoreProduction. Quindi, puoi scegliere di concedere l'accesso a quella visualizzazione solo agli utenti che hanno un motivo aziendale per visualizzare tali risorse. A una vista separata che include le risorse Beta dell'ambiente Alpha o possono accedere diversi utenti che devono visualizzare tali risorse. Per informazioni su come controllare chi può accedere a quali visualizzazioni, consultaConcessione dell'accesso alle visualizzazioni di Resource Explorer per la ricerca.

Sintassi della stringa di query

Questa sezione fornisce informazioni sugli aspetti di base della sintassi delle query, dei filtri e degli operatori di filtro.

Nozioni di base

Nella sua forma più elementare, a QueryString è un insieme di parole chiave di testo in formato libero unite implicitamente da un operatore logico. OR Separate ogni parola chiave dalle altre utilizzando uno spazio, come illustrato nell'esempio seguente:

ec2 billing test gamma

Resource Explorer valuta questo elenco di parole chiave per indicare:

ec2 OR billing OR test OR gamma

Resource Explorer ordina i risultati in base alla pertinenza, dando maggiore preferenza alle risorse che corrispondono a un numero maggiore di termini di ricerca. Le risorse che non corrispondono a uno o più termini non sono escluse dai risultati. Tuttavia, Resource Explorer li considera di minore rilevanza e li colloca più in basso nei risultati di ricerca.

Se si specifica una stringa vuota per il QueryString parametro, la query restituisce le prime 1.000 risorse disponibili tramite la vista utilizzata per l'operazione. Il numero massimo di risorse che possono essere restituite da qualsiasi query è 1.000.

Nota

AWS si riserva il diritto di aggiornare la logica di corrispondenza e gli algoritmi di pertinenza per la valutazione delle parole chiave di testo in formato libero in modo da poter fornire ai clienti i risultati più pertinenti. Pertanto, i risultati restituiti per le stesse query utilizzando parole chiave con testo in formato libero potrebbero cambiare nel tempo. Se hai bisogno di risultati più deterministici, ti consigliamo di utilizzare i filtri. La logica di abbinamento dei filtri non cambia nel tempo.

Filtri

Puoi limitare i risultati della tua ricerca in modo più rigoroso includendo filtri. A differenza delle parole chiave di testo, i filtri vengono valutati nella query con l'ANDoperatore. Ad esempio, si consideri la seguente query composta da due parole chiave in formato libero e due filtri:

test instance service:EC2 region:us-west-2

Questa interrogazione viene valutata come segue:

( test OR instance ) AND service:EC2 AND region:us-west-2

I filtri vengono sempre valutati utilizzando operatori ANDlogici. Se una risorsa non corrisponde al filtro, tale risorsa non viene inclusa nei risultati. I risultati della query di esempio includono tutte le risorse associate ad Amazon EC2 e che si trovano negli Stati Uniti occidentali (Oregon) Regione AWS e hanno almeno una delle parole chiave allegate in qualche modo.

Nota

A causa dell'implicitoAND, puoi utilizzare correttamente solo un filtro per un attributo che può avere un solo valore associato alla risorsa. Ad esempio, una risorsa può far parte di una Regione AWS sola risorsa. 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:, etag.value:.

Nella tabella seguente sono elencati i nomi dei filtri disponibili che è possibile utilizzare in una query di ricerca di Resource Explorer.

Nome del filtro	Descrizione ed esempio
accountid:	Il Account AWS proprietario della risorsa. Resource Explorer include nei risultati solo le risorse di proprietà dell'account specificato. accountid:123456789012
application:	Questo filtro consente di cercare risorse con una chiave di awsApplication tag e un valore di gruppo di risorse. È possibile eseguire la ricerca in base al nome dell'applicazione o al gruppo di risorse dell'applicazioneARN. application:MyApplicationName application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced Nota Per utilizzare questo filtro, la visualizzazione deve avere accesso ai dati di etichettatura.
id:	L'identificatore di una singola risorsa, espresso come nome di risorsa Amazon (ARN). id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE
region:	La posizione Regione AWS in cui si trova la risorsa. Resource Explorer include nei risultati solo le risorse che risiedono nell'area specificata Regione AWS. region:us-east-1 Nota Digitando solo il codice regionale (senza filtro, ad esempious-east-1) non si ottengono gli stessi risultati di. region:us-east-1 Questo risultato è dovuto al fatto che, trattandosi di una parola chiave di testo in formato libero che non è un filtro, il codice regionale viene suddiviso in singole parti. Ad esempio, us-east-1 viene cercato come useast, e. 1 Questa suddivisione in componenti non si verifica quando si utilizza il region: prefisso.
region:global	Un caso speciale per il region: filtro che è possibile utilizzare per trovare risorse che non sono associate a un individuo Regione AWS ma che sono considerate di portata globale. region:global Nota Digitando solo la parola chiave global non si ottengono gli stessi risultati del region:global fatto che la parola letterale «globale» non è associata alle risorse globali. La digitazione global come parola chiave restituisce solo le risorse a cui è associata quella stringa letterale.
resourcetype:	Il tipo di risorsa in service:type notazione. Resource Explorer include nei risultati solo le risorse del tipo specificato. resourcetype:ec2:instance
resourcetype.supports:	Questo filtro consente di cercare risorse che supportano i tag. tagsè l'unico valore supportato. Resource Explorer include nei risultati solo le risorse etichettabili. resourcetype.supports:tags
service:	Il Servizio AWS che è associato al tipo di risorsa. Resource Explorer include nei risultati solo le risorse create e gestite dal servizio specificato. service:ec2
tag:	Una coppia chiave/valore di tag espressa come. <key>=<value> Resource Explorer include nei risultati solo le risorse che hanno un tag con una chiave corrispondente e il valore specificato. tag:environment=production
tag:all	Un caso speciale del tag: filtro che consente di cercare risorse a cui sono associati uno o più tag creati dall'utente, anche se il tipo di risorsa non è supportato in Resource Explorer. Nota Le risorse con tag AWS creati dal servizio vengono ancora visualizzate nei risultati di questo filtro.
tag:none	Un caso speciale del tag: filtro che consente di cercare tutte le risorse a cui non sono allegati tag creati dall'utente. Nota Le risorse con tag AWS creati dal servizio vengono ancora visualizzate nei risultati di questo filtro.
tag.key:	Una chiave tag. Resource Explorer include nei risultati solo le risorse che hanno un tag con una chiave corrispondente, indipendentemente dal valore. tag.key:environment
tag.value:	Un valore di tag. Resource Explorer include nei risultati solo le risorse che hanno un tag con un valore corrispondente, indipendentemente dal nome della chiave. tag.value:production

Operatori di filtro

È possibile modificare le parole chiave e i filtri includendo uno degli operatori mostrati nella tabella seguente come parte della stringa.

Operatore	Descrizione ed esempio
"multiple word phrase" oppure "hyphenated-phrase"	Racchiude una frase composta da più parole che deve essere trattata come una singola parola chiave racchiusa tra virgolette doppie (). " " Resource Explorer include solo le risorse che corrispondono all'intera frase, con tutte le parole insieme e nell'ordine specificato. Se non si utilizzano le virgolette doppie, Resource Explorer suddivide la frase nei suoi componenti mediante spazi o trattini e include risorse che corrispondono ai singoli componenti, anche se non sono insieme o in un ordine diverso. Le virgolette devono essere racchiuse intorno a tutto ciò che segue l'operatore. "This matches only resources with the whole sentence." This matches resources with any of the words. "us-east-1"— corrisponde solo alle risorse associate a quella regione esatta. us-east-1— corrisponde a qualsiasi risorsa che contenga «us» o «east» o «1". -tag:"environment=production"
keyword*	Corrispondenza con i caratteri jolly del prefisso. È possibile inserire un carattere jolly (un asterisco*) solo alla fine della stringa. Resource Explorer include nei risultati solo le risorse con valori che iniziano con il testo del prefisso precedente a. * L'esempio seguente corrisponde a tutto ciò Regioni AWS che inizia conus-east. region:us-east* Importante La ricerca unificata inserisce automaticamente un operatore di caratteri jolly (*) alla fine della prima parola chiave della stringa. Ciò significa che i risultati della ricerca unificata includono risorse che corrispondono a qualsiasi stringa che inizia con la parola chiave specificata. La ricerca eseguita dalla casella di testo Query nella pagina di ricerca delle risorse della console Resource Explorer non aggiunge automaticamente un carattere jolly. È possibile inserire * manualmente un dopo qualsiasi termine nella stringa di ricerca.
-keyword	Notoperatore. Puoi inserire un trattino (-) all'inizio della parola chiave o del filtro per invertire i risultati della ricerca. Resource Explorer esclude dai risultati tutte le risorse che corrispondono alla parola chiave o al filtro che segue questo operatore. L'esempio seguente fa sì che tutte le risorse associate al EC2 servizio Amazon vengano escluse dai risultati. -service:ec2 Importante Se si utilizza il AWS CLI search comando e il valore del --query-string parametro ha l'-operatore come primo carattere, è necessario separare il nome del parametro dal relativo valore con un carattere di segno uguale (=) anziché il consueto carattere di spazio. Se si utilizza il carattere spazio, la stringa viene CLI interpretata erroneamente. Ad esempio, la seguente query ha esito negativo. aws resource-explorer-2 search --query-string "-tag:none region:us-east-1" La seguente stringa di query corretta, con uno spazio = sostitutivo, 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 query in modo che - non sia il primo carattere del valore del parametro, potete utilizzare il carattere di spazio standard. La seguente stringa di query funziona. aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<special character>	È possibile evitare i caratteri speciali che devono essere inclusi esattamente come illustrati anziché interpretati. Se il testo include uno dei caratteri speciali ( * " - : = \), dovete precedere quel carattere da una barra rovesciata (\) per assicurarvi che il carattere venga preso alla lettera. L'esempio seguente mostra come utilizzare una parola chiave di testo in formato libero che include il carattere trattino () (). - "my-key-word" Inoltre, per evitare che Resource Explorer suddivida l'espressione in corrispondenza dei trattini in tre parole chiave separate, è possibile racchiudere l'intera frase tra virgolette doppie. "my\-key\-word" Per inserire una barra rovesciata letterale, inserite due caratteri di barra rovesciata in una riga. La prima barra rovesciata viene interpretata come escape e la seconda barra rovesciata è il carattere letterale da inserire. "some_text\\some_more_text"

Nota

Se la vista include i tag allegati alle risorse, l'Searchoperazione non genera errori di convalida per le stringhe di ricerca, poiché un filtro non valido potrebbe essere interpretato anche come una ricerca di testo in formato libero. Ad esempio, anche se cat:blue sembra un filtro, Resource Explorer non può analizzarlo come tale perché cat: non è uno dei filtri validi e definiti. Resource Explorer interpreta invece l'intera stringa come una stringa di ricerca in formato libero per consentirle di abbinare elementi come il nome di una chiave di tag o una parte di un file. ARN

L'operazione genera un errore di convalida se una delle seguenti condizioni è vera:

• La vista non include informazioni sui tag

• La query di ricerca utilizza esplicitamente un filtro di tag (tag.key:,tag.value:, otag:)