Ricerca di documenti SSM - AWS Systems Manager
Utilizzo della ricerca a testo liberoUtilizzo dei filtriAggiunta di documenti ai preferiti

Ricerca di documenti SSM

È possibile cercare nell'archivio documenti di AWS Systems Manager (SSM) i documenti SSM utilizzando la ricerca a testo libero o una ricerca basata su filtro. Per trovare più facilmente i documenti SSM usati di frequente, puoi aggiungerli ai tuoi preferiti. Le sezioni seguenti descrivono come utilizzare queste funzionalità.

Utilizzo della ricerca a testo libero

La casella di ricerca nella pagina Documents (Documenti) di Systems Manager supporta la ricerca a testo libero. La ricerca a testo libero confronta il termine o i termini di ricerca immessi con il nome del documento in ogni documento SSM. Se si immette un singolo termine di ricerca, ad esempio ansible, Systems Manager restituisce tutti i documenti SSM in cui è stato trovato questo termine. Se si immettono più termini di ricerca, Systems Manager esegue la ricerca utilizzando un'istruzione OR. Ad esempio, se si specifica ansible e linux, la ricerca restituisce tutti i documenti con Una delle parole chiave nel nome.

Se si immette un termine di ricerca a testo libero e si sceglie un'opzione di ricerca, ad esempio Platform type (Tipo di piattaforma), la ricerca utilizza un'istruzione AND e restituisce tutti i documenti con la parola chiave nel nome e il tipo di piattaforma specificato.

Nota

Notare i seguenti dettagli relativi alla ricerca a testo libero.

  • La ricerca a testo libero non fa distinzione tra maiuscole e minuscole.

  • I termini di ricerca devono avere un minimo di tre caratteri e un massimo di 20 caratteri

  • La ricerca a testo libero accetta fino a cinque termini di ricerca.

  • Se si immette uno spazio fra i termini di ricerca, il sistema include lo spazio durante la ricerca.

  • È possibile combinare la ricerca a testo libero con altre opzioni di ricerca, ad esempio Document type (Tipo di documento) o Platform type (Tipo di piattaforma).

  • Il filtro relativo al Document Name Prefix (Prefisso del nome del documento) e la ricerca a testo libero non possono essere utilizzati insieme. Si escludono a vicenda.

Cercare un documento SSM

  1. Apri la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Inserire i termini di ricerca nella casella di ricerca e premere Invio.

Ricerca di documenti a testo libero utilizzando il AWS CLI

Eseguire una ricerca di documenti a testo libero utilizzando il CLI

  1. Se non lo hai ancora fatto, installa e configura AWS Command Line Interface (AWS CLI).

    Per informazioni, consulta la pagina Installazione o aggiornamento della versione più recente di AWS CLI.

  2. Per effettuare la ricerca di documenti a testo libero con un singolo termine, eseguire il comando seguente. In questo comando, sostituisci search_term (ricerca_termine) con le tue informazioni.

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term"

    Ecco un esempio:

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg" --region us-east-2

    Per eseguire ricerche utilizzando più termini che creano un'istruzione AND, eseguire il comando seguente. In questo comando, sostituisci search_term_1 (ricerca_termine_1) e search_term_2 (ricerca_termine_2) con le tue informazioni.

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term_1","search_term_2","search_term_3" --region us-east-2

    Ecco un esempio:

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg","aws-ec2","restart" --region us-east-2

Utilizzo dei filtri

La pagina Documents (Documenti) di Systems Manager visualizza automaticamente i seguenti filtri quando si sceglie la casella di ricerca.

  • Prefisso del nome del documento

  • Tipi di piattaforma

  • Tipo di documento

  • Chiave tag

Opzioni per il filtro nella pagina Documenti SSM.

È possibile cercare documenti SSM utilizzando un singolo filtro. Se si desidera restituire un insieme più specifico di documenti SSM, è possibile applicare più filtri. Di seguito è riportato un esempio di ricerca che utilizza i filtri Platform types (Tipi di piattaforma) e Document name prefix (Prefisso del nome del documento).

Applicazione di più opzioni per il filtro nella pagina Documenti SSM.

Se si applicano più filtri, Systems Manager crea istruzioni di ricerca diverse in base ai filtri scelti:

  • Se si applica lo stesso filtro più volte, ad esempio Document name prefix (Prefisso del nome del documento), Systems Manager esegue la ricerca utilizzando un'istruzione OR. Ad esempio, se si specifica un filtro di Document name prefix (Prefisso del nome del documento)=AWS e un secondo filtro di Document name prefix (Prefisso del nome del documento)=Lambda, la ricerca restituisce tutti i documenti con il prefisso “AWS“ e tutti i documenti con il prefisso “Lambda“.

  • Se applichi filtri diversi, ad esempio Document name prefix (Prefisso del nome del documento) e Platform types (Tipi di piattaforma), Systems Manager esegue la ricerca utilizzando un'istruzione AND. Ad esempio, se specifichi un filtro Document name prefix=AWS (Prefisso del nome del documento=AWS) e un filtro Platform types=Linux (Tipi di piattaforma=Linux), la ricerca restituirà tutti i documenti con il prefisso "AWS" specifici per la piattaforma Linux.

Nota

Le ricerche che utilizzano i filtri fanno distinzione tra maiuscole e minuscole.

Aggiunta di documenti ai preferiti

Per trovare più facilmente i documenti SSM usati di frequente, aggiungili ai tuoi preferiti. Puoi aggiungere ai preferiti fino a 20 documenti per tipo di documento per ogni Account AWS e Regione AWS. Puoi scegliere, modificare e visualizzare i tuoi preferiti dalla AWS Management Console Documenti. Le procedure seguenti descrivono come scegliere, modificare e visualizzare i preferiti.

Aggiunta di un documento SSM ai preferiti

  1. Apri la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Seleziona l'icona a forma di stella accanto al nome del documento che desideri aggiungere ai preferiti.

Rimozione di un documento SSM dai preferiti

  1. Apri la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Deseleziona l'icona a forma di stella accanto al nome del documento che desideri rimuovere dai preferiti.

Visualizzazione dei preferiti dalla AWS Management Console Documenti

  1. Apri la console di AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Seleziona la scheda Preferiti.