Enumerar y filtrar los recursos - Amazon Elastic Compute Cloud

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

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 (Instancias)).

  2. Elija el campo de búsqueda.

  3. Elija el filtro de la lista.

  4. Elija un valor de filtrado.

  5. Cuando haya terminado, quite el filtro.

La funcionalidad de búsqueda y filtrado presenta unas pocas diferencias entre la versión de la consola de Amazon EC2 antigua y la nueva.

La nueva consola 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 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.

La nueva 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 le permite buscar un valor en todos los atributos de sus recursos, sin especificar un atributo para 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, la búsqueda 123 coincide con todas las instancias que tienen 123 en cualquiera de sus atributos, como una dirección IP, un ID de instancia, un ID de VPC o un ID de AMI. Si la búsqueda de texto libre devuelve coincidencias inesperadas, aplique filtros adicionales.

Buscar por atributos

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 (Instancias), comience a escribir Instance state. A medida que escribe los caracteres, aparecen los dos tipos de filtros para Instance state (Estado de la instancia): API filters (Filtros de API) y Client filters (Filtros de cliente).

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

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

  3. Seleccione la opción Stopped (Detenido) de la lista.

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. Las búsquedas inversas se realizan prefijando la palabra clave de búsqueda con el signo de exclamación (!).

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 a todas aquellas que tengan el estado terminated. Para ello:

  1. En el campo de búsqueda de la pantalla Instances (Instancias), comience a escribir Instance state. A medida que escribe los caracteres, aparecen los dos tipos de filtros para Instance state (Estado de la instancia): API filters (Filtros de API) y Client filters (Filtros de cliente).

  2. 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 valores posibles para el atributo seleccionado.

  3. Escriba ! (signo de exclamación) para mostrar los filtros inversos.

  4. Elija !terminated de la lista.

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.

Este es otro ejemplo de uso de la búsqueda inversa. Para enumerar todas las instancias a las que no se ha asignado el grupo de seguridad denominado launch-wizard-1, realice una búsqueda por el atributo Security group name (Nombre del grupo de seguridad) y, como palabra clave, escriba !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. Por ejemplo, para buscar todas las instancias t2.micro, t2.small, y t2.medium, busque por el atributo Instance Type (Tipo de instancia) y escriba la palabra clave t2.

nota

La búsqueda parcial 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 de expresiones regulares

Para utilizar búsquedas de expresiones regulares, debe habilitar Use regular expression matching (Usar coincidencia de expresiones regulares) en las 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]+.*. La búsqueda de expresiones regulares no distingue entre mayúsculas y minúsculas.

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 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 siguientes valores: prod, prods y production; "prod*" coincide con todos los valores, mientras que "prod?" solo coincide con prod y prods. Para utilizar los valores literales, aplíqueles escape con una barra invertida (\). Por ejemplo, "prod\*" coincidiría con prod*.

nota

La búsqueda de comodín solo se admite con búsquedas de atributos en filtros API. No se admite con búsquedas de palabras clave y búsquedas de atributos solo 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 detenido.

La consola de Amazon EC2 antigua 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 le permite buscar un valor en todos los atributos de sus recursos. 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, la búsqueda 123 coincide con todas las instancias que tienen 123 en cualquiera de sus atributos, como una dirección IP, un ID de instancia, un ID de VPC o un ID de AMI. Si la búsqueda de texto libre devuelve coincidencias inesperadas, aplique filtros adicionales.

Buscar por atributos

La búsqueda por un atributo le permite buscar un atributo específico en todos sus recursos. Por ejemplo, puede buscar en el atributo State (Estado) todas las instancias para devolver solo las instancias que están en el estado stopped. Para ello:

  1. En el campo de búsqueda de la pantalla Instancias, comience a escribir Instance State. A medida que introduce caracteres, aparece una lista de atributos coincidentes.

  2. Seleccione Instance State (Estado de instancia) de la lista. Aparecerá una lista de valores posibles para el atributo seleccionado.

  3. Seleccione Stopped (Detenido) en la lista.

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. Las búsquedas inversas se realizan prefijando la palabra clave de búsqueda con el signo de exclamación (!). Por ejemplo, para enumerar todas las instancias que no han finalizado, busque por el atributo Instance State (Estado de instancia) y escriba la palabra clave !Terminated.

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 desea buscar. Por ejemplo, para buscar todas las instancias t2.micro, t2.small, y t2.medium, busque por el atributo Instance Type (Tipo de instancia) y escriba la palabra clave t2.

Búsqueda de expresiones regulares

Las expresiones regulares resultan de utilidad cuando necesita que los valores en un campo coincidan con un determinado patrón. Por ejemplo, para buscar todas las instancias que tienen un valor de atributo que comienza con s, busque ^s. O bien, para buscar todas las instancias que tienen un valor de atributo que termina con xyz, busque xyz$. La búsqueda de expresiones regulares no distingue entre mayúsculas y minúsculas.

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 detenido.

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:

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 2020-03-31). 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.