Búsqueda de referencia de sintaxis de consulta en Resource Explorer - Explorador de recursos de AWS
Cómo funcionan las consultas en Resource ExplorerSintaxis de cadenas de consulta

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.

Búsqueda de referencia de sintaxis de consulta en Resource Explorer

Explorador de recursos de AWS le ayuda a encontrar AWS recursos individuales en su Cuentas de AWS. Para ayudarlo a encontrar los recursos exactos que busca, Resource Explorer acepta cadenas de consultas de búsqueda que admitan la sintaxis descrita en este tema. Para ver consultas de ejemplo que muestran cómo utilizar las características que se describen aquí, consulte Ejemplo de consultas de búsqueda del Explorador de recursos.

nota

En este momento, las etiquetas adjuntas a los recursos AWS Identity and Access Management (IAM), como los roles o los usuarios, no están indexadas.

Cómo funcionan las consultas en Resource Explorer

Las consultas de búsqueda siempre utilizan una vista. Si no especificas ninguna de forma explícita, el Explorador de recursos utilizará la vista designada como predeterminada para la vista en la Región de AWS que estés trabajando.

Las vistas determinan qué recursos están disponibles para consultarlos. Puede crear vistas diferentes para que cada una proporcione un conjunto de recursos diferente.

Por ejemplo, puede crear una vista que incluya solo los recursos etiquetados con la clave Environment y el valor Production. A continuación, puede optar por conceder acceso a esa vista únicamente a los usuarios que tengan un motivo empresarial para ver esos recursos. Diferentes usuarios que necesiten ver esos recursos podrían acceder a una vista independiente que incluya los recursos del entorno Alpha o Beta. Para obtener más información sobre el control de quiénes acceden a qué vistas, consulte Otorgar acceso a las vistas de Resource Explorer para la búsqueda.

Sintaxis de cadenas de consulta

En esta sección se proporciona información sobre los aspectos básicos de la sintaxis de las consultas, los filtros y los operadores de filtro.

Conceptos básicos

En su forma más básica, un QueryString es un conjunto de palabras clave de texto de formato libre a las que se une implícitamente un operador lógico OR. Para separar cada palabra clave de las demás, utilice un espacio, como se muestra en el siguiente ejemplo:

ec2 billing test gamma

Resource Explorer evalúa esta lista de palabras clave en el sentido de:

ec2 OR billing OR test OR gamma

Resource Explorer ordena los resultados por relevancia, dando mayor preferencia a los recursos que coinciden con un mayor número de términos de búsqueda. Los recursos que no coincidan con uno o más de los términos no se excluyen de los resultados. Sin embargo, Resource Explorer los considera de menor relevancia y los coloca más abajo en los resultados de búsqueda.

Si especifica una cadena vacía para el parámetro QueryString, la consulta proporcionará los primeros 1000 recursos que estén disponibles a través de la vista utilizada para la operación. El número máximo de recursos que puede proporcionar una consulta es 1000.

nota

AWS se reserva el derecho de actualizar la lógica de coincidencia y los algoritmos de relevancia para evaluar las palabras clave de texto de formato libre, de modo que podamos ofrecer a los clientes los resultados más relevantes. Por lo tanto, los resultados proporcionados para las mismas consultas con palabras clave de texto de formato libre pueden cambiar con el tiempo. Si necesita resultados más determinantes, le recomendamos que utilice filtros. La lógica de coincidencia de filtros no cambia con el tiempo.

Filtros

Puede limitar los resultados de la consulta de forma más estricta mediante la inclusión de filtros. A diferencia de las palabras clave de texto, los filtros se evalúan en la consulta con el ANDoperador. Por ejemplo, considere la siguiente consulta, que consta de dos palabras clave de formato libre y dos filtros:

test instance service:EC2 region:us-west-2

Esta consulta se evalúa de la siguiente manera:

( test OR instance ) AND service:EC2 AND region:us-west-2

Los filtros siempre se evalúan mediante operadores ANDlógicos. Si un recurso no coincide con el filtro, no se incluye en los resultados. Los resultados de la consulta de ejemplo incluyen todos los recursos que estén asociados a Amazon EC2 y se encuentren en el oeste de EE. UU. (Oregón) Región de AWS y que tengan al menos una de las palabras clave adjuntas de alguna manera.

nota

Debido a AND implícito, solo puede utilizar correctamente un filtro para un atributo que pueda tener únicamente un valor asociado al recurso. Por ejemplo, un recurso solo puede formar parte de una Región de AWS. Por lo tanto, la consulta indica que no hay resultados.

region:us-east-1 region:us-west-1

Esta limitación no se aplica a los filtros de los atributos que pueden tener varios valores al mismo tiempo, como por ejemplo, tag:, tag.key: y tag.value:.

En la siguiente tabla, se muestran los nombres de filtro disponibles que puede utilizar en una consulta de búsqueda de Resource Explorer.

Nombre del filtro Descripción y ejemplo

accountid:

El Cuenta de AWS propietario del recurso. Resource Explorer incluye en los resultados únicamente los recursos que pertenecen a la cuenta especificada.

accountid:123456789012

application:

Este filtro le permite buscar recursos con una clave de etiqueta de awsApplication y un valor de grupo de recursos. Puede buscar por nombre de aplicación o por grupo de recursos de la aplicaciónARN.

application:MyApplicationName

application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

nota

Para usar este filtro, la vista debe tener acceso a los datos de etiquetado.

id:

El identificador de un recurso individual, expresado como un nombre de recurso de Amazon (ARN).

id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE

region:

El Región de AWS lugar donde se encuentra el recurso. El explorador de recursos incluye en los resultados solo los recursos que residen en lo especificado Región de AWS.

region:us-east-1

nota

Si se escribe únicamente el código de región (sin filtro, por ejemplo us-east-1), no se obtienen los mismos resultados que region:us-east-1. Este resultado se debe a que, al tratarse de una palabra clave de texto de formato libre que no es un filtro, el código de región se divide en partes individuales. Por ejemplo, us-east-1 se busca como us, east y1. Este desglose en componentes no se produce cuando se utiliza el prefijo region:.

region:global

Un caso especial para el region: filtro que se puede utilizar para buscar recursos que no están asociados a una persona Región de AWS pero que se consideran de alcance global.

region:global

nota

Si solo se escribe la palabra clave global, no se obtienen los mismos resultados como region:global, porque la palabra literal “global” no está asociada a los recursos globales. Si global se escribe como palabra clave, solo se muestran los recursos que tienen esa cadena literal asociada al recurso.

resourcetype:

El tipo de recurso en notación service:type. Resource Explorer incluye en los resultados únicamente los recursos que pertenecen a la cuenta especificada.

resourcetype:ec2:instance

resourcetype.supports:

Este filtro le permite buscar recursos que admitan etiquetas. tagses el único valor admitido. El explorador de recursos incluye en los resultados solo los recursos que se pueden etiquetar.

resourcetype.supports:tags

service:

El Servicio de AWS que está asociado al tipo de recurso. Resource Explorer incluye en los resultados únicamente los recursos que pertenecen a la cuenta especificada.

service:ec2

tag:

Un par clave/valor de etiqueta expresado como <key>=<value>. Resource Explorer incluye en los resultados solo los recursos que tienen una etiqueta con una clave coincidente y el valor especificado.

tag:environment=production

tag:all

Un caso especial del tag: filtro que permite buscar recursos que tengan adjuntas una o más etiquetas creadas por el usuario, incluso si el explorador de recursos no admite el tipo de recurso.

nota

Los recursos con etiquetas creadas por el servicio de AWS siguen apareciendo en los resultados de este filtro.

tag:none

Un caso especial del filtro tag: que permite buscar cualquier recurso que no tenga ninguna etiqueta creada por el usuario adjunta.

nota

Los recursos con etiquetas creadas por el servicio de AWS siguen apareciendo en los resultados de este filtro.

tag.key:

Una clave de etiqueta. Resource Explorer incluye en los resultados solo los recursos que tienen una etiqueta con una etiqueta coincidente, independientemente del valor.

tag.key:environment

tag.value:

Un valor de etiqueta. Resource Explorer incluye en los resultados solo los recursos que tienen una etiqueta con una clave coincidente, independientemente del nombre de la clave.

tag.value:production

Operadores de filtro

Puede modificar las palabras clave y los filtros incluyendo uno de los operadores que se muestran en la siguiente tabla como parte de la cadena.

Operador Descripción y ejemplo

"multiple word phrase"

o

"hyphenated-phrase"

Escriba una frase de varias palabras que deba tratarse como una sola palabra clave con comillas dobles (" "). Resource Explorer incluye solo los recursos que coinciden con la frase completa, con todas las palabras juntas y en el orden especificado.

Si no usa comillas dobles, Resource Explorer divide la frase en sus componentes mediante espacios o guiones e incluye los recursos que coinciden con los componentes individuales, incluso si no están juntos o en un orden diferente. Las comillas deben estar alrededor de todo lo que aparece después del operador.

"This matches only resources with the whole sentence."

This matches resources with any of the words.

"us-east-1": solo coincide con los recursos que están asociados a esa región exacta.

us-east-1: coincide con cualquier recurso que contenga las palabras “EE. UU.”, “este” o “1”.

-tag:"environment=production"

keyword*

Coincidencia de prefijos con caracteres comodín. Puede colocar un carácter comodín (un asterisco *) únicamente al final de la cadena. Resource Explorer incluye en los resultados solo los recursos cuyos valores comiencen con el texto del prefijo antes de *. El siguiente ejemplo coincide con todos los Regiones de AWS que comienzan por. us-east

region:us-east*

importante

La búsqueda unificada inserta automáticamente un operador de caracteres comodín (*) al final de la primera palabra clave de la cadena. Esto significa que los resultados de la búsqueda unificada incluyen recursos que coinciden con cualquier cadena que comience por la palabra clave especificada.

La búsqueda realizada mediante el cuadro de texto Consulta de la página de Búsqueda de recursos de la consola de Resource Explorer no añade automáticamente un carácter comodín. Puede insertar un * manualmente después de cualquier término de la cadena de búsqueda.

-keyword

Operador Not. Puede colocar un guion (-) al principio de su palabra clave o filtro para invertir los resultados de la búsqueda. Resource Explorer excluye de los resultados los recursos que coincidan con la palabra clave o el filtro que sigue a este operador. El siguiente ejemplo hace que todos los recursos asociados al EC2 servicio de Amazon se excluyan de los resultados.

-service:ec2

importante

Si usa el AWS CLI search comando y el valor del --query-string parámetro tiene el - operador como primer carácter, debe separar el nombre del parámetro de su valor con un signo igual (=) en lugar del carácter de espacio habitual. Si utiliza el carácter de espacio, CLI malinterpreta la cadena. Por ejemplo, la siguiente consulta indica un error.

aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"

La siguiente consulta corregida, con un = que reemplaza el espacio, funciona según lo esperado.

aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"

Si cambia el orden de los filtros en la cadena de consulta para que - no sea el primer carácter del valor del parámetro, puede utilizar el carácter de espacio estándar. La siguiente cadena de consulta funciona.

aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<special character>

Puede evitar los caracteres especiales que deben incluirse exactamente como se muestra en lugar de interpretarse. Si el texto incluye uno de los caracteres especiales ( * " - : = \), debe colocarlo delante de una barra invertida (\) para asegurarse de que el carácter se interpreta literalmente. El siguiente ejemplo muestra cómo utilizar una palabra clave de texto de formato libre que incluya el carácter ("my-key-word") de guion (-).

Además, para evitar que Resource Explorer divida la expresión de los guiones en tres palabras clave distintas, puede escribir toda la frase entre comillas dobles.

"my\-key\-word"

Para insertar una barra invertida literal, inserte dos caracteres de barra invertida en una fila. La primera barra invertida se interpreta como el escape y la segunda barra invertida es el carácter literal que se debe insertar.

"some_text\\some_more_text"
nota

Si la vista incluye las etiquetas adjuntas a los recursos, la operación Search no arroja errores de validación para las cadenas de búsqueda, ya que un filtro que no es válido también podría interpretarse como una búsqueda de texto de formato libre. Por ejemplo, aunque cat:blue parezca un filtro, Resource Explorer no puede analizarlo como tal porque cat: no es uno de los filtros definidos y válidos. En su lugar, Resource Explorer interpreta toda la cadena como una cadena de búsqueda de formato libre para permitir que coincida con elementos como el nombre de una clave de etiqueta o una parte de una. ARN

La operación arroja un error de validación si se da alguna de estas condiciones:

  • La vista no incluye información sobre las etiquetas

  • La consulta de búsqueda utiliza explícitamente un filtro de etiquetas (tag.key:, tag.value: o tag:)