As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Exemplo de consultas de pesquisa do Explorador de Recursos
Os exemplos a seguir mostram a sintaxe dos tipos comuns de consultas que você pode usar no Explorador de recursos da AWS.
Importante
Se usar o comando search da AWS CLI e o valor do parâmetro --query-string tiver o operador - como primeiro caractere, você deverá separar o nome do parâmetro do seu valor com um caractere de sinal de igual (=), em vez de usar o caractere de espaço habitual. Se você usar o caractere de espaço, a CLI interpretará a string incorretamente. Por exemplo, a consulta a seguir não funciona.
aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"
A consulta corrigida a seguir, com um = substituindo o espaço, funciona como esperado.
aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"
Se você alterar a ordem dos filtros na string de consulta para que - não seja o primeiro caractere no valor do parâmetro, poderá usar o caractere de espaço padrão. A consulta a seguir funciona.
aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
Pesquisar recursos não marcados
Se você quiser usar o controle de acesso por atributo (ABAC)
O filtro tag:none só se aplica às tags criadas pelo usuário. As tags que são geradas e mantidas pela AWS estão isentas desse filtro e continuam a aparecer nos resultados.
tag:none
Para excluir também todas as tags do sistema criadas pela AWS, adicione um segundo filtro, como mostrado no exemplo a seguir. O primeiro elemento string de consulta duplica o exemplo anterior filtrando todas as tags criadas pelo usuário. As tags do sistema criadas pela AWS sempre começam com as letras aws. Portanto, você pode usar o operador lógico NOT (-) com o filtro tag.key para excluir também todos os recursos que tenham uma tag com um nome de chave que comece com aws.
tag:none -tag.key:aws*
Pesquisar recursos marcados
Para encontrar todos os recursos que têm uma tag de qualquer tipo, você pode usar o operador lógico NOT (-) com o filtro de caixa especial tag: none como se segue.
-tag:none
Pesquisar recursos em que falta uma tag específica
Também relacionado ao ABAC, talvez você queira pesquisar todos os recursos que não têm nenhuma tag com uma chave especificada. O exemplo a seguir usa o operador lógico NOT - para retornar todos os recursos em que falta uma tag com o nome da chave Department.
-tag.key:Department
Pesquisar os recursos que têm valores de tag inválidos
Por razões de conformidade, talvez você queira pesquisar todos os recursos que com valores de tag faltando ou com erros de ortografia em tags importantes. O exemplo a seguir retorna todos os recursos que têm uma tag com o nome da chave environment. Porém, a consulta exclui qualquer recurso que tenha um dos valores válidos prod, integ ou dev. Quaisquer resultados que apareçam nessa consulta têm algum outro valor que você deverá investigar e corrigir.
Importante
As pesquisas do Explorador de Recursos não diferenciam maiúsculas de minúsculas e não conseguem distinguir entre nomes de chave e valores cuja única diferença é o uso maiúsculas e minúsculas. Por exemplo, os valores no exemplo a seguir correspondem a PROD, prod, PrOd ou a qualquer variação. Porém, algumas aplicações usam tags de modos que diferenciam entre maiúsculas e minúsculas. Recomendamos que você padronize uma estratégia de uso de maiúsculas e minúsculas para a sua organização, como, por exemplo, usar somente valores e nomes de chaves de tags começando com letra minúscula. Uma abordagem consistente pode ajudar a evitar a confusão que pode ser causada por tags que só diferem no uso de maiúsculas e minúsculas.
tag.key:environment -tag:environment=prod -tag:environment=integ -tag:environment=dev
Pesquisar recursos em um subconjunto de Regiões da AWS
Use o operador curinga '*' para combinar todas as regiões de determinada área do mundo. O exemplo a seguir retorna todos os recursos que estão nas regiões da Europa (UE).
region:eu-*
Pesquisar recursos globais
Use o valor global de caso especial do filtro de region: para encontrar os recursos que são considerados globais e não associados a uma região individual.
region:global
Pesquisar recursos de um determinado tipo que estão localizados em uma região específica
Quando você usa vários filtros, o Explorador de Recursos avalia a expressão combinando os prefixos com operadores lógicos AND implícitos. O exemplo a seguir retorna todos os recursos que estão na região Ásia-Pacífico (Hong Kong) AND são instâncias do Amazon EC2.
region:ap-east-1 resourcetype:ec2:instance
nota
Por causa do AND implícito, você só pode usar com sucesso um único filtro para um atributo que só pode ter um valor associado ao recurso. Por exemplo, um recurso não pode fazer parte de mais de uma Região da AWS. Portanto, a consulta a seguir não retorna nenhum resultado.
region:us-east-1 region:us-west-1
Essa limitação não se aplica aos filtros de atributos que podem ter vários valores ao mesmo tempo, como tag:, tag.key: e tag.value:.
Pesquisar recursos que têm um termo composto de várias palavras
Coloque um termo composto de várias palavras entre aspas duplas (") para retornar apenas resultados que tenham o termo inteiro na ordem especificada. Sem aspas duplas, o Explorador de Recursos retorna os recursos que correspondem a qualquer uma das palavras separadas que compõe o termo. Por exemplo, a consulta a seguir usa aspas duplas para retornar somente os recursos que correspondem ao termo "west
wing". A consulta não retorna os recursos na Região da AWS us-west-2 (ou em qualquer outra região que inclua west em seu código) ou recursos que correspondam à palavra "wing" sem a palavra "west".
"west wing"
Pesquisar recursos que fazem parte de uma pilha do CloudFormation
Quando você cria um recurso como parte de uma pilha do AWS CloudFormation, ele é automaticamente marcado com o nome da pilha. O exemplo a seguir retorna todos os recursos que foram criados como parte da pilha especificada.
tag:aws:cloudformation:stack-name=my-stack-name
