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](using-search-query-examples.md). **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](manage-views-grant-access.md). ## 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 **AND**operador. 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 **AND**ló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` 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)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html). `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` 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` y`1`. 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` 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. `tags`es 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 `=`. 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. 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. 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*` 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](https://console.aws.amazon.com/resource-explorer/home#/explorer) 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` 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"
| | \$1 | 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:`)