Enumerar y filtrar los recursos - Amazon Elastic Compute Cloud

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

    
							Edite un filtro.
  7. Cuando haya terminado, quite el filtro.

La funcionalidad de búsqueda y filtro difiere ligeramente entre la consola 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 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 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 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 (Instancias), 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. Elija Confirm.

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

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 Instances (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.

Enumerar y filtrar recursos entre regiones mediante Amazon EC2 Global View

Amazon EC2 Global View permite ver algunos de sus recursos de Amazon EC2 y Amazon VPC en una sola región de AWS o a través de varias regiones en una sola consola. Con Amazon EC2 Global View, puede ver un resumen de todas las VPC, subredes, instancias, grupos de seguridad y volúmenes de todas las regiones para las que se encuentra habilitada su cuenta de AWS. Amazon EC2 Global View también ofrece la funcionalidad de búsqueda global que permite buscar recursos específicos o tipos de recursos específicos en varias regiones simultáneamente.

Amazon EC2 Global View no permite modificar recursos de ninguna manera.

Permisos necesarios

Un usuario de IAM debe contar con los siguientes permisos para utilizar Amazon EC2 Global View.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:DescribeVpcs", "ec2:DescribeRegions", "ec2:DescribeVolumes", "ec2:DescribeSubnets", "ec2:DescribeSecurityGroups" ], "Resource": "*" }] }

Para utilizar Amazon EC2 Global View

Abra la consola de Amazon EC2 Global View en https://console.aws.amazon.com/ec2globalview/home.

La consola consta de dos pestañas:

  • Region explorer (Explorador de regiones): esta pestaña incluye las siguientes secciones:

    • Resource summary (Resumen de recursos): proporciona información general de alto nivel sobre los recursos de todas las regiones.

      Enabled Regions (Regiones habilitadas) indica el número de regiones para las que se encuentra habilitada su cuenta de AWS. Los campos restantes indican el número de recursos que tiene actualmente en esas regiones. Elija cualquiera de los enlaces para ver los recursos de ese tipo en todas las regiones. Por ejemplo, si el enlace debajo de la etiqueta Instances (Instancias) es 29 de 10 regiones, indica que actualmente tiene 29 instancias en 10 regiones. Elija el enlace para ver una lista de las 29 instancias.

    • Resource counts per Region (Recuentos de recursos por región): enumera todas las regiones de AWS (incluido aquellas para las que no se encuentra habilitada su cuenta) y proporciona totales para cada tipo de recurso para cada región.

      Elija el nombre de una región para ver todos los recursos de todos los tipos de esa región específica. Por ejemplo, elija África (Ciudad del Cabo) af-south-1 para ver todas las VPC, subredes, instancias, grupos de seguridad y volúmenes de esa región. También puede seleccionar una región y elegir View resources for selected Region (Ver recursos para la región seleccionada).

      Elija el valor de un tipo de recurso específico en una región específica para solo ver los recursos de ese tipo en esa región. Por ejemplo, elija el valor de instancias para África (Ciudad del Cabo) af-south-1 a fin de ver solo las instancias de esa región.

  • Global search (Búsqueda global): esta pestaña permite buscar recursos específicos o tipos de recursos específicos en una sola región o en varias regiones. También permite ver los detalles de un recurso específico.

    Para buscar recursos, ingrese los criterios de búsqueda en el campo que precede a la cuadrícula. Puede buscar por región, tipo de recurso y las etiquetas asignadas a los recursos.

    Para consultar los detalles de un recurso específico, selecciónelo en la cuadrícula. También puede elegir el ID de recurso de un recurso para abrirlo en su respectiva consola. Por ejemplo, elija un ID de instancia para abrir la instancia en la consola de Amazon EC2 o elija un ID de subred a fin de abrir la subred en la consola de Amazon VPC.