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.
Ejemplo de consultas de búsqueda del Explorador de recursos
En los ejemplos siguientes se muestra la sintaxis de los tipos de consultas comunes que puede utilizar en Explorador de recursos de AWS.
importante
Si usa el comando AWS CLI search
y el valor del parámetro --query-string
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, la CLI malinterpretará 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, en la 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 consulta funciona.
aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
Buscar recursos sin etiquetar
Si quiere usar el control de acceso basado en atributos (ABAC)
El filtro tag:none
se aplica únicamente a las etiquetas creadas por el usuario. Las etiquetas generadas y mantenidas por AWS están exentas de este filtro y siguen apareciendo en los resultados.
tag:none
Para excluir también todas las etiquetas de sistema AWS creadas, añada un segundo filtro como se muestra en el ejemplo siguiente. El primer elemento de la cadena de consulta duplica el ejemplo anterior al filtrar todas las etiquetas creadas por los usuarios. Las etiquetas de sistema creadas por AWS siempre comienzan con las letras aws
. Por lo tanto, puede utilizar el operador lógico NOT (-) con el filtro tag.key para excluir también los recursos que tengan una etiqueta cuyo nombre clave comience por aws
.
tag:none -tag.key:aws*
Buscar recursos sin etiquetar
Para encontrar todos los recursos que tengan una etiqueta de cualquier tipo, puede usar el operador lógico NOT (-) con el filtro para casos especiales tag: none de la siguiente manera.
-tag:none
Buscar recursos a los que les falte una etiqueta específica
También en relación con ABAC, es posible que desee buscar todos los recursos que no tengan una etiqueta con una clave específica. En el siguiente ejemplo, se utiliza el operador lógico NOT - para proporcionar todos los recursos a los que les falta una etiqueta con el nombre de la clave Department
.
-tag.key:Department
Buscar recursos que tengan valores de etiqueta no válidos
Por motivos de conformidad, es posible que desee buscar todos los recursos a los que les falten valores de etiqueta o que estén mal escritos en las etiquetas importantes. El siguiente ejemplo proporciona todos los recursos que tengan una etiqueta con el nombre clave environment
. Sin embargo, la consulta filtra cualquier recurso que tenga uno de los valores válidos prod
, integ
o dev
. Los resultados que aparecen en esta consulta tienen algún otro valor que debe investigar y corregir.
importante
Las búsquedas del explorador de recursos no distinguen entre mayúsculas y minúsculas y no pueden distinguir entre nombres clave y valores que solo difieren por la forma en que se escriben en mayúscula. Por ejemplo, los valores del siguiente ejemplo coinciden con PROD
, prod
, PrOd
o con cualquier variación. Sin embargo, algunas aplicaciones utilizan etiquetas que distinguen mayúsculas de minúsculas. Se recomienda estandarizar una estrategia de capitalización para su organización, por ejemplo, utilizando únicamente nombres y valores clave de etiquetas en minúscula. Un enfoque coherente puede ayudar a evitar la confusión que puede provocar tener etiquetas que solo se diferencien por la forma en que se escriben con mayúscula.
tag.key:environment -tag:environment=prod -tag:environment=integ -tag:environment=dev
Buscar recursos en un subconjunto de Regiones de AWS
Usa el operador comodín '*' para hacer coincidir todas las regiones de una zona determinada del mundo. El siguiente ejemplo devuelve todos los recursos que se encuentran en las regiones de Europa (UE).
region:eu-*
Buscar recursos globales
Utilice el valor global
de casos especiales para el filtro region:
para encontrar los recursos que se consideran globales y no están asociados a una región individual.
region:global
Busque recursos de un tipo determinado que estén ubicados en una región específica
Cuando se utilizan varios filtros, el explorador de recursos evalúa la expresión combinando los prefijos con los operadores lógicos implícitos AND
. El ejemplo siguiente muestra que todos los recursos que se encuentran en la región Asia-Pacífico (Hong Kong) AND
son instancias de Amazon EC2.
region:ap-east-1 resourcetype:ec2:instance
nota
Debido al 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 un 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:
.
Buscar recursos que tengan un término de varias palabras
Escriba un término de varias palabras entre comillas dobles (") para obtener solo los resultados que contengan todo el término en el orden especificado. Sin comillas dobles, el explorador de recursos proporciona los recursos que coinciden con las palabras individuales que componen el término. Por ejemplo, en la siguiente consulta se utilizan comillas dobles para mostrar únicamente los recursos que coinciden con el término "west
wing"
. La consulta no coincide con los recursos de la región us-west-2
Región de AWS (ni de ninguna otra región que incluya west
en su código) ni con los recursos que coincidan con la palabra «ala» sin la palabra «oeste».
"west wing"
Buscar recursos que formen parte de una pila de CloudFormation específica
Cuando crea un recurso como parte de una pila AWS CloudFormation, todos se etiquetan automáticamente con el nombre de la pila. El siguiente ejemplo demuestra todos los recursos que se crearon como parte de la pila especificada.
tag:aws:cloudformation:stack-name=
my-stack-name