• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
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à.
# Ricerca di documenti SSM
È possibile cercare documenti SSM nell'archivio documenti AWS Systems Manager (SSM) utilizzando la ricerca a testo libero o una ricerca basata su filtri. 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 **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 **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 **Tipo di documento** o **Tipo di piattaforma**.
Il filtro relativo al **Prefisso del nome del documento** e la ricerca a testo libero non possono essere utilizzati insieme. Si escludono a vicenda.
**Per cercare un documento SSM**
1. Apri la console all' AWS Systems Manager indirizzo. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Nel pannello di navigazione, scegli **Documenti**.
1. Inserire i termini di ricerca nella casella di ricerca e premere Invio.
### Esecuzione della ricerca di documenti a testo libero utilizzando il AWS CLI
**Eseguire una ricerca di documenti a testo libero utilizzando il CLI**
1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.
Per informazioni, consulta la pagina [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Per effettuare la ricerca di documenti a testo libero con un singolo termine, eseguire il comando seguente. In questo comando, *search\$1term* sostituiscilo 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\$1term\$11* e *search\$1term\$12* 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 **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.\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/ssm-documents-filters-1.png)
È 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 **Tipi di piattaforma** e **Prefisso del nome del documento**.
![\[Applicazione di più opzioni per il filtro nella pagina Documenti SSM.\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/ssm-documents-filters-2.png)
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 **Prefisso del nome del documento**, Systems Manager esegue la ricerca utilizzando un'istruzione `OR`. Ad esempio, se si specifica un filtro di **Prefisso del nome del documento**=**AWS** e un secondo filtro di **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 **Prefisso del nome del documento** e **Tipi di piattaforma**, Systems Manager esegue la ricerca utilizzando un'istruzione `AND`. Ad esempio, se specifichi un filtro **Prefisso del nome del documento**=**AWS** (=) e un filtro **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 Account AWS e Regione AWS. Puoi scegliere, modificare e visualizzare i tuoi preferiti dalla Console di gestione AWS Documenti. Le procedure seguenti descrivono come scegliere, modificare e visualizzare i preferiti.
**Aggiunta di un documento SSM ai preferiti**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Documenti**.
1. 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 AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Documenti**.
1. Deseleziona l'icona a forma di stella accanto al nome del documento che desideri rimuovere dai preferiti.
**Per visualizzare i preferiti dai documenti Console di gestione AWS**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Documenti**.
1. Seleziona la scheda **Preferiti**.