• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Búsqueda de documentos de SSM
Puede buscar documentos de SSM en el almacén de documentos AWS Systems Manager (SSM) mediante la búsqueda de texto libre o una búsqueda basada en filtros. También puede marcar documentos como favoritos para ayudarlo a encontrar documentos de SSM usados con frecuencia. En las siguientes secciones, se describe cómo utilizar estas características.
## Uso de la búsqueda de texto libre
El cuadro de búsqueda en la página **Documents** (Documentos) de Systems Manager admite las búsquedas de texto libre. La búsqueda de texto libre compara el término o los términos de búsqueda que introduce con el nombre del documento en cada documento de SSM. Si introduce un solo término de búsqueda, por ejemplo **ansible**, Systems Manager devuelve todos los documentos de SSM donde se encontró este término. Si introduce varios términos de búsqueda, Systems Manager buscará mediante una instrucción `OR`. Por ejemplo, si especifica **ansible** y **linux**, a continuación, la búsqueda devuelve todos los documentos con *cualquier* palabra clave en su nombre.
Si ingresa un término de búsqueda de texto libre y elige una opción de búsqueda, como **Platform type** (Tipo de plataforma), a continuación, la búsqueda utiliza una instrucción `AND` y devuelve todos los documentos con la palabra clave en su nombre y el tipo de plataforma especificado.
**nota**
Tenga en cuenta los siguientes detalles sobre la búsqueda de texto libre.
La búsqueda de texto libre *no* distingue entre mayúsculas y minúsculas.
Los términos de búsqueda deben tener tres caracteres como mínimo y 20 caracteres como máximo.
La búsqueda de texto libre acepta hasta cinco términos de búsqueda.
Si ingresa un espacio entre los términos de búsqueda, el sistema incluye el espacio al realizar la búsqueda.
Puede combinar la búsqueda de texto libre con otras opciones de búsqueda, como **Document type** (Tipo de documento) o **Platform type** (Tipo de plataforma).
El filtro **Document name prefix** (Prefijo de nombre del documento) y la búsqueda de texto libre no se pueden utilizar juntos. Son mutuamente excluyentes.
**Para buscar un documento de SSM**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Documentos**.
1. Escriba los términos de búsqueda en el cuadro de búsqueda y presione “Enter” (Ingresar).
### Realizar la búsqueda de documentos de texto libre mediante la AWS CLI
**Para realizar la búsqueda de documentos de texto libre mediante la CLI**
1. Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).
Para obtener más información, consulte [Instalación o actualización de la última versión de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Para realizar búsquedas de documentos de texto libre con un solo término, ejecute el siguiente comando. En este comando, sustituya *search\$1term* con su propia información.
```
aws ssm list-documents --filters Key="SearchKeyword",Values="search_term"
```
A continuación se muestra un ejemplo.
```
aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg" --region us-east-2
```
Para realizar una búsqueda con varios términos que crean una instrucción `AND` ejecute el siguiente comando. En este comando, sustituya *search\$1term\$11* y *search\$1term\$12* con su propia información.
```
aws ssm list-documents --filters Key="SearchKeyword",Values="search_term_1","search_term_2","search_term_3" --region us-east-2
```
A continuación se muestra un ejemplo.
```
aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg","aws-ec2","restart" --region us-east-2
```
## Uso de filtros
La página **Documents** (Documentos) de Systems Manager muestra automáticamente los siguientes filtros cuando elije el cuadro de búsqueda.
+ Prefijo de nombre del documento
+ Tipos de plataformas
+ Tipo de documento
+ Clave de etiqueta
![\[Opciones de filtrado en la página documentos de SSM.\]](http://docs.aws.amazon.com/es_es/systems-manager/latest/userguide/images/ssm-documents-filters-1.png)
Puede buscar documentos de SSM mediante un único filtro. Si desea volver un conjunto más específico de documentos de SSM, puede aplicar varios filtros. A continuación, se muestra un ejemplo de una búsqueda que utiliza los filtros **Platform types** (Tipos de plataforma) y **Document name prefix** (Prefijo de nombre del documento).
![\[Aplicación de varias opciones de filtro en la página Documentos de SSM.\]](http://docs.aws.amazon.com/es_es/systems-manager/latest/userguide/images/ssm-documents-filters-2.png)
Si aplica varios filtros, Systems Manager crea instrucciones de búsqueda diferentes basadas en los filtros que elija:
+ Si aplica el *mismo* filtro varias veces, por ejemplo **Document name prefix** (Prefijo de nombre del documento), a continuación, Systems Manager busca mediante una instrucción `OR`. Por ejemplo, si especifica un filtro **Prefijo de nombre del documento**=**AWS** y un segundo filtro **Prefijo de nombre del documento**=**Lambda**, a continuación, la búsqueda devuelve todos los documentos con el prefijo “`AWS`” y todos los documentos con el prefijo “`Lambda`”.
+ Si aplica filtros *diferentes*, por ejemplo **Prefijo del nombre del documento** y **Tipos de plataformas**, Systems Manager realiza la búsqueda mediante el uso de una instrucción `AND`. Por ejemplo, si especifica un filtro **Prefijo del nombre del documento**=**AWS** y un filtro **Tipos de plataformas**=**Linux**, la búsqueda devuelve todos los documentos con el prefijo “`AWS`” específicos de la plataforma Linux.
**nota**
Las búsquedas que utilizan filtros distinguen entre mayúsculas y minúsculas.
## Adición de documentos a favoritos
Para ayudarlo a encontrar los documentos de SSM que usa con frecuencia, agregue documentos a sus favoritos. Puede marcar como favoritos hasta 20 documentos por tipo de documento, por Cuenta de AWS y Región de AWS. Puede elegir, modificar y ver sus favoritos desde la Consola de administración de AWS de documentos. En los siguientes procedimientos, se describe cómo seleccionar, modificar y ver los favoritos.
**Para agregar un documento de SSM a favoritos**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Documentos**.
1. Seleccione el icono de estrella situado junto al nombre del documento que desea marcar como favorito.
**Para eliminar un documento de SSM de favoritos**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Documentos**.
1. Anule la selección del icono de estrella junto al nombre del documento que desea eliminar de sus favoritos.
**Para ver los favoritos desde la Consola de administración de AWS de documentos**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Documentos**.
1. Seleccione la pestaña **Favoritos**.