Enumerar y filtrar los recursos

Puede usar la consola de Amazon EC2 para obtener una lista de algunos tipos de recursos. Puede obtener una lista de cada tipo de recurso mediante su correspondiente comando o acción de API. Si tiene muchos recursos, puede filtrar los resultados para incluir, o excluir, solo los recursos que coincidan con determinados criterios.

Enumerar y filtrar recursos mediante la consola

Contenido

• Enumerar recursos mediante la consola
• Filtrar recursos mediante la consola
  • Filtros compatibles

Enumerar recursos mediante la consola

Puede ver los tipos de recursos de Amazon EC2 más comunes mediante la consola. Para ver recursos adicionales, use la interfaz de línea de comandos o las acciones de API.

Para enumerar recursos de EC2 mediante la consola

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija la opción que corresponda al tipo de recurso. Por ejemplo, para enumerar las instancias, elija Instancias.

   La página muestra todos los recursos del tipo de recurso seleccionado.

Filtrar recursos mediante la consola

Para filtrar una lista de recursos

1. En el panel de navegación, seleccione un tipo de recurso (por ejemplo, Instances (Instancia[s])).

2. Elija el campo de búsqueda.

3. Seleccione el filtro en la lista.

4. Seleccione un operador; por ejemplo, = (igual que). Algunos atributos tienen más operadores disponibles para seleccionar. Tenga en cuenta que no todas las pantallas permiten seleccionar un operador.

5. Seleccione un valor de filtro.

6. Para editar un filtro seleccionado, elija el token del filtro (cuadro azul), realice las ediciones necesarias y luego elija Apply (Aplicar). Tenga en cuenta que no todas las pantallas permiten editar el filtro seleccionado.

   

7. Cuando haya terminado, quite el filtro.

Filtros compatibles

La consola de Amazon EC2 admite dos tipos de filtrado.

• El filtrado de API ocurre en el lado del servidor. El filtrado se aplica en la llamada a la API, lo que reduce el número de recursos devueltos por el servidor. Permite filtrar rápidamente entre grandes conjuntos de recursos, y puede reducir el tiempo de transferencia de datos y el costo entre el servidor y el navegador. El filtrado de API admite los operadores = (igual que) y : (contiene), y siempre distingue entre mayúsculas y minúsculas.

• El filtrado del cliente ocurre en el lado del cliente. Le permite filtrar los datos que ya están disponibles en el navegador (en otras palabras, los datos que ya han sido devueltos por la API). El filtrado de clientes funciona bien junto con un filtro API para filtrar a conjuntos de datos más pequeños en el navegador. Además de los operadores = (igual que) y : (contiene), el filtrado de clientes también puede admitir operadores de rangos, como >= (mayor o igual que), y de negación (inversos), como != (distinto de).

La consola de Amazon EC2 admite los siguientes tipos de búsquedas:

Buscar por palabra clave

La búsqueda por palabra clave es una búsqueda de texto libre que permite buscar un valor en la totalidad de los atributos o las etiquetas de los recursos, sin especificar una clave de atributo o etiqueta que se deba buscar.

nota

Todas las búsquedas de palabras clave utilizan el filtrado de clientes.

Para buscar por palabra clave, escriba o pegue lo que está buscando en el cuadro de búsqueda y, a continuación elija Entrar. Por ejemplo, buscar 123 devuelve todas las instancias que tengan 123 en cualquiera de sus atributos, como una dirección IP, un ID de instancia, un ID de VPC o un ID de AMI, o bien en cualquiera de sus etiquetas, como el nombre. Si la búsqueda de texto libre devuelve coincidencias inesperadas, aplique filtros adicionales.

Buscar por atributo

La búsqueda por un atributo le permite buscar un atributo específico en todos sus recursos.

nota

Las búsquedas de atributos utilizan filtrado de API o filtrado de clientes, según el atributo seleccionado. Al realizar una búsqueda de atributos, los atributos se agrupan en consecuencia.

Por ejemplo, puede buscar el atributo Instance State (Estado de la instancia) en todas las instancias para devolver solo las instancias que tienen el estado stopped. Para ello:

1. En el campo de búsqueda de la pantalla Instances (Instancia[s]), comience a escribir Instance state. A medida que escribe los caracteres, los dos tipos de filtros aparecen para el estado de instancia: filtros la API y filtros de cliente.

2. Para buscar en el lado del servidor, elija Instance state (Estado de la instancia) en los filtros de API. Para buscar en el lado del cliente, elija Instance state (client) (Estado de la instancia [cliente]) en los filtros de cliente.

   Aparecerá una lista de posibles operadores para el atributo seleccionado.

3. Elija el operador = (igual que).

   Aparecerá una lista de valores posibles para el atributo y el operador seleccionados.

4. Seleccione Stopped (Detenido) de la lista.

Buscar por etiqueta

La búsqueda por etiqueta permite filtrar los recursos de la tabla mostrada actualmente por una clave de etiqueta o un valor de etiqueta.

Las búsquedas de etiquetas utilizan filtrado de API o filtrado de clientes, en función de la configuración de la ventana Preferences (Preferencias).

Para garantizar el filtrado de API para etiquetas

1. Abra la ventana Preferences (Preferencias).

2. Desmarque la casilla de verificación Use regular expression matching (Utilizar coincidencia de expresiones regulares). Si esta casilla de verificación está seleccionada, se aplica filtrado de clientes.

3. Seleccione la casilla de verificación Use case sensitive matching (Utilizar coincidencia de mayúsculas y minúsculas). Si esta casilla de verificación no está marcada, se aplica filtrado de clientes.

4. Seleccione Confirmar.

Cuando se busca por etiqueta, se pueden utilizar los siguientes valores:

• (vacío): se buscan todos los recursos con la clave de etiqueta especificada, pero no debe haber ningún valor de etiqueta.

• All values (Todos los valores): se buscan todos los recursos con la clave de etiqueta especificada y cualquier valor de etiqueta.

• Not tagged (No etiquetado): se buscan todos los recursos que no tengan la clave de etiqueta especificada.

• Valor mostrado: se buscan todos los recursos con la clave de etiqueta especificada y el valor de etiqueta especificado.

Puede utilizar las siguientes técnicas para mejorar o refinar sus búsquedas.

Búsqueda inversa

Las búsquedas inversas permiten buscar recursos que no coinciden con un valor especificado. En las pantallas Instances (Instancia[s]) y AMIs (AMI), las búsquedas inversas se realizan seleccionando el operador != (distinto de) o !: (no contiene) y luego seleccionando un valor. En otras pantallas, las búsquedas inversas se realizan anteponiendo el signo de exclamación de cierre (!) a la palabra clave de la búsqueda.

nota

La búsqueda inversa solo se admite con búsquedas de palabras clave y búsquedas de atributos en filtros de cliente. No se admite con búsquedas de atributos en filtros API.

Por ejemplo, puede buscar el atributo Instance State (Estado de la instancia) en todas las instancias para excluir todas las instancias que tengan el estado terminated. Para ello:

1. En el campo de búsqueda de la pantalla Instances (Instancia[s]), comience a escribir Instance state. A medida que escribe los caracteres, los dos tipos de filtros aparecen para el estado de instancia: filtros la API y filtros de cliente.

2. En Client filters (Filtros de cliente), elija Instance state (client) (Estado de la instancia [cliente]). La búsqueda inversa solo se admite en los filtros de cliente.

   Aparecerá una lista de posibles operadores para el atributo seleccionado.

3. Elija != (distinto de) y luego terminated (terminada).

Para filtrar instancias en función de un atributo de estado de la instancia, también puede utilizar los iconos de búsqueda ( ) en la columna Instance state (Estado de la instancia). El icono de búsqueda con un signo más ( + ) muestra todas las instancias que coincidan con ese atributo. El icono de búsqueda con un signo menos ( - ) excluye todas las instancias que coincidan con ese atributo.

Otro ejemplo de uso de la búsqueda inversa: para ver una lista de todas las instancias que no tengan asignado el grupo de seguridad denominado launch-wizard-1, en Client filters (Filtros de cliente) busque por el atributo Security group name (Nombre del grupo de seguridad), elija != y, en la barra de búsqueda, ingrese launch-wizard-1.

Búsqueda parcial

Con búsquedas parciales, puede buscar valores de cadena parciales. Para realizar una búsqueda parcial, introduzca solo una parte de la palabra clave que desee buscar. En las pantallas Instances (Instancia[s]) y AMIs (AMI), las búsquedas parciales solo se pueden realizar con el operador : (contiene). En otras pantallas, se puede seleccionar el atributo de filtro de cliente e ingresar inmediatamente solo una parte de la palabra clave que se desee buscar. Por ejemplo, en la pantalla Instance type (Tipo de instancia), para buscar todas las instancias t2.micro, t2.small y t2.medium, busque por el atributo Instance Type (Tipo de instancia) y, para la palabra clave, ingrese t2.

Búsqueda de expresiones regulares

Para utilizar búsquedas de expresiones regulares, se debe seleccionar la casilla de verificación Use regular expression matching (Utilizar coincidencia de expresiones regulares) en la ventana Preferences (Preferencias).

Las expresiones regulares resultan de utilidad cuando necesita que los valores en un campo coincidan con un determinado patrón. Por ejemplo, para buscar un valor que comience con s, busque ^s. Para buscar un valor que termine con xyz, busque xyz$. O bien, para buscar un valor que comience con un número seguido de uno o más caracteres, busque [0-9]+.*.

nota

La búsqueda de expresiones regulares solo se admite con búsquedas de palabras clave y búsquedas de atributos en filtros de cliente. No se admite con búsquedas de atributos en filtros API.

Búsqueda distinguiendo entre mayúsculas y minúsculas

Para utilizar búsquedas que distingan entre mayúsculas y minúsculas, se debe seleccionar la casilla de verificación Use case sensitive matching (Utilizar coincidencia de mayúsculas y minúsculas) en la ventana Preferences (Preferencias). La preferencia de distinción entre mayúsculas y minúsculas solo se aplica a los filtros de cliente y de etiqueta.

nota

Los filtros de API siempre distinguen entre mayúsculas y minúsculas.

Búsqueda con comodín

Utilice el comodín * para que coincida con cero o más caracteres. Utilice el comodín ? para que coincida con cero o un carácter. Por ejemplo, si tiene un conjunto de datos con los valores prod, prods yproduction, buscar prod* devuelve todos los valores, mientras que prod? solo devuelve prod y prods. Para utilizar los valores literales, antepóngales una barra invertida (\) como carácter de escape. Por ejemplo, "prod\*" devolvería prod*.

nota

La búsqueda con comodín solo se admite en búsquedas de atributos y etiquetas en filtros de API. No se admite en búsquedas de palabras clave, ni en búsquedas de atributos y etiquetas en filtros de cliente.

Combinación de búsquedas

En general, se unen automáticamente varios filtros con el mismo atributo con OR. Por ejemplo, la búsqueda de Instance State : Running y Instance State : Stopped devuelve todas las instancias que se están ejecutando O detenidas. Para unir la búsqueda con AND, busque entre diferentes atributos. Por ejemplo, buscar Instance State : Running y Instance Type : c4.large devuelve solo instancias que son de tipo c4.large Y que están en el estado de ejecución.

Enumerar y filtrar mediante la CLI y la API

Cada tipo de recurso tiene un comando de CLI y una acción de API correspondiente que se usa para enumerar los recursos de ese tipo. Las listas de recursos resultantes pueden ser largas, por lo que puede ser más rápido y útil filtrar los resultados para incluir solo los recursos que coincidan con criterios específicos.

Consideraciones de filtrado

• Puede especificar varios filtros y varios valores de filtro en una sola solicitud.

• Puede utilizar comodines con los valores del filtro. Un asterisco (*) coincide con cero o con más caracteres y un signo de interrogación (?) coincide con cero o un carácter.

• Los valores de filtro distinguen entre mayúsculas y minúsculas.

• La búsqueda puede incluir los valores literales de los caracteres comodín; en ese caso, solo tiene que aplicarles escape con una barra oblicua inversa antes del carácter. Por ejemplo, un valor de \*amazon\?\\ busca la cadena literal *amazon?\.

Filtros compatibles

Para ver los filtros compatibles para cada recurso de Amazon EC2, consulte la siguiente documentación:

• AWS CLI: Los comandos describe en la AWS CLI Command Reference de Amazon EC2.

• Tools for Windows PowerShell: Los comandos Get en la AWS Tools for PowerShell Cmdlet Reference de Amazon EC2.

• API de consulta: Las Describe acciones de API en la Referencia de la API de Amazon EC2.

ejemplo Ejemplo: Especificar un filtro único

Puede enumerar sus instancias de Amazon EC2 mediante describe-instances. Sin filtros, la respuesta contiene información para todos los recursos. Puede utilizar el siguiente comando para incluir solo las instancias en ejecución en la salida.

aws ec2 describe-instances --filters Name=instance-state-name,Values=running

Para enumerar solo los ID de instancia de las instancias en ejecución, agregue el parámetro --query de la siguiente manera.

aws ec2 describe-instances --filters Name=instance-state-name,Values=running --query "Reservations[*].Instances[*].InstanceId" --output text

A continuación, se muestra un ejemplo del resultado.

i-0ef1f57f78d4775a4
i-0626d4edd54f1286d
i-04a636d18e83cfacb

ejemplo Ejemplo: Especificar varios filtros o valores de filtro

Si especifica varios filtros o varios valores de filtro, el recurso debe coincidir con todos los filtros para incluirlos en los resultados.

Puede utilizar el siguiente comando para enumerar todas las instancias cuyo tipo es m5.large o m5d.large.

aws ec2 describe-instances --filters Name=instance-type,Values=m5.large,m5d.large

Puede utilizar el siguiente comando para enumerar todas las instancias detenidas cuyo tipo es t2.micro.

aws ec2 describe-instances --filters Name=instance-state-name,Values=stopped Name=instance-type,Values=t2.micro

ejemplo Ejemplo: Usar comodines en un valor de filtro

Si especifica database como valor de filtro para el filtro description al describir las instantáneas de EBS mediante describe-snapshots, el comando devuelve solo las instantáneas cuya descripción es “database”.

aws ec2 describe-snapshots --filters Name=description,Values=database

El comodín * coincide con cero o más caracteres. Si especifica *database* como valor de filtro, el comando solo devuelve instantáneas cuya descripción incluye la base de datos de palabras.

aws ec2 describe-snapshots --filters Name=description,Values=*database*

El comodín ? coincide con exactamente 1 carácter. Si especifica database? como valor del filtro, el comando solo devuelve instantáneas cuya descripción es “database” o “database” seguido de un carácter.

aws ec2 describe-snapshots --filters Name=description,Values=database?

Si especifica database????, el comando solo devuelve instantáneas cuya descripción es “database” seguido de hasta cuatro caracteres. Excluye las descripciones con “database” seguido de cinco o más caracteres.

aws ec2 describe-snapshots --filters Name=description,Values=database????

ejemplo Ejemplo: Filtro basado en la fecha

Con la AWS CLI, puede usar JMESPath para filtrar los resultados mediante expresiones. Por ejemplo, el siguiente comando describe-snapshots muestra los ID de todas las instantáneas creadas por su Cuenta de AWS (representada por 123456789012) antes de la fecha especificada (representada por 31/03/2020). Si no especifica el propietario, los resultados incluyen todas las instantáneas públicas.

aws ec2 describe-snapshots --filters Name=owner-id,Values=123456789012 --query "Snapshots[?(StartTime<='2020-03-31')].[SnapshotId]" --output text

El siguiente comando muestra los ID de todas las instantáneas creadas en el intervalo de fechas especificado.

aws ec2 describe-snapshots --filters Name=owner-id,Values=123456789012 --query "Snapshots[?(StartTime>='2019-01-01') && (StartTime<='2019-12-31')].[SnapshotId]" --output text

Filtro basado en etiquetas

Para obtener ejemplos de cómo filtrar una lista de recursos según sus etiquetas, consulte Trabajar con etiquetas mediante la línea de comandos.

Visualización de recursos entre regiones mediante Amazon EC2 Global View

Amazon EC2 Global View permite ver y buscar recursos de Amazon EC2 y Amazon VPC en una sola región de AWS o en varias regiones simultáneamente en una sola consola. Para obtener más información, consulte Amazon EC2 Global View.