Usar o Explorador de recursos da AWS para pesquisar recursos - Explorador de recursos da AWS

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

Usar o Explorador de recursos da AWS para pesquisar recursos

O objetivo principal de habilitar o Explorador de recursos da AWS em sua Conta da AWS é permitir que os usuários pesquisem recursos na conta. Use o AWS Management Console ou a AWS Command Line Interface (AWS CLI) para pesquisar recursos usando o Explorador de Recursos.

A seguir estão algumas das principais características da pesquisa do Explorador de Recursos.

  • Toda pesquisa deve usar uma visualização.

    A visualização é o que o Explorador de Recursos usa para determinar quem tem permissões para ver quais recursos. Para usar uma visualização em uma operação de pesquisa do Explorador de Recursos, o usuário deve ter uma permissão Allow na operação resource-explorer-2:Search da visualização especificada. Essa permissão vem de uma política de permissão baseada em identidade anexada à entidade principal que fez a solicitação.

    A visualização pode incluir um filtro que limite quais recursos podem ser incluídos nos resultados. Criando visualizações diferentes que usam filtros e concedendo a diferentes entidades principais acesso a diferentes visualizações, você pode configurar um ambiente em que cada grupo de usuários só pode visualizar os recursos relevantes para eles.

    Para obter mais informações sobre visualizações, consulte Gerenciar visualizações do Explorador de Recursos para fornecer acesso para pesquisa.

  • O Explorador de Recursos usa processos assíncronos em segundo plano para manter seus índices.

    O Explorador de Recursos pode levar algum tempo para que seus processos de indexação descubram os recursos recém-criados ou modificados e os adicionem ao índice local. Pode levar um tempo adicional para que o Explorador de Recursos replique as alterações feitas nos índices locais no índice agregador.

    O mesmo se aplica aos recursos que você exclui. Pode levar algum tempo para que essa exclusão seja descoberta pelo processo de indexação e para que as informações daquele recurso sejam removidas do índice local. É necessário tempo adicional para que o Explorador de Recursos replique essa exclusão do índice local no índice agregador da conta.

    O Explorador de Recursos pode levar até 36 horas para mostrar as adições, modificações e exclusões feitas nos recursos nos resultados de pesquisa em todas as regiões em que você ativou o Explorador de Recursos.

  • Uma pesquisa no Explorador de Recursos ocorre em uma Região da AWS.

    Cada região em que você ativa o Explorador de Recursos contém um índice apenas dos recursos armazenados naquela região. As visualizações também estão associadas às regiões e só podem retornar os recursos encontrados no índice daquela região. A única exceção é o índice agregador, que recebe uma cópia replicada de todos os índices locais para possibilitar a pesquisa em todas as regiões da conta.

  • A pesquisa entre regiões exige um índice agregador para a conta.

    Para permitir que os usuários pesquisem recursos em todas as Regiões da AWS, o administrador deve designar uma região para conter o índice agregador da conta. Uma cópia de cada índice local é automaticamente replicada no índice agregador.

    Por isso, apenas as visualizações na região do índice agregador podem retornar resultados que incluam recursos de todas as Regiões da AWS na conta.

  • Uma consulta consiste em qualquer número de palavras-chave e filtros de texto em formato livre.

    Palavras-chave em formato livre são combinadas na consulta usando operadores lógicos OR. Os filtros que usam nomes de filtro definidos pelo Explorador de Recursos são combinados na consulta usando operadores lógicos AND. Considere o exemplo de consulta a seguir.

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

    Isso é avaliado pelo Explorador de Recursos como se segue.

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

    Essa consulta exige que os recursos correspondentes sejam recursos do Amazon EC2 na região Oeste dos EUA (Oregon) e tenham pelo menos uma das palavras-chave (teste, instância) anexada de alguma forma, como nome, descrição ou tags.

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

  • Uma pesquisa só pode retornar os primeiros 1.000 resultados.

    Esse requisito inclui uma pesquisa com uma string de consulta vazia que corresponde a todos os recursos. Para ver recursos além dos 1.000 retornados por uma string de consulta vazia, você deve usar consultas para restringir os resultados encontrados aos que deseja ver e limitar o número de correspondências a menos de 1.000.

  • Existe uma cota por conta para o número de operações de pesquisa que podem ser executadas.

    As cotas limitam quantas consultas você pode fazer por segundo e quantas consultas pode fazer por mês. Para obter as cotas específicas, consulte Cotas do Explorador de Recursos.

AWS Management Console
Para pesquisar recursos usando o Explorador de Recursos
  1. Na página Pesquisa de recursos, comece escolhendo a visualização que deseja usar. Você só pode escolher entre as visualizações para as quais tem permissão de acesso.

  2. Em Consulta, insira os termos e filtros de pesquisa que identificam os recursos que você deseja ver. Para obter informações sobre todas as opções de sintaxe disponíveis, consulte Referência da sintaxe de consulta de pesquisa do Explorador de Recursos.

  3. Pressione Enter para enviar sua escolha.

    O Explorador de Recursos exibe todos os resultados que correspondem ao Filter definido na visualização e à consulta fornecida. Os resultados são classificados por relevância, com os recursos que correspondem a mais termos da consulta aparecendo no topo da lista e os recursos que correspondem a menos termos aparecendo mais abaixo na lista.

  4. Escolha o identificador de um recurso para navegar até o console nativo desse tipo de recurso, onde você pode interagir com o recurso de todas as formas compatíveis com esse serviço.

AWS CLI
Para pesquisar recursos usando o Explorador de Recursos

Execute o comando a seguir para pesquisar recursos usando a visualização especificada. Essa visualização deve existir na região em que você executa a operação. O exemplo a seguir pesquisa instâncias do Amazon EC2 que estão marcadas como env=production na região Leste dos EUA (Ohio) (us-east-2). Para obter informações sobre todas as opções de sintaxe disponíveis para o parâmetro query-string, consulte Referência da sintaxe de consulta de pesquisa do Explorador de Recursos.

$ aws resource-explorer-2 search \ --region us-east-1 \ --query-string "resourcetype:AWS::EC2::Instance tag:env=production" --view-arn arn:aws:resource-explorer-2:us-east-2:123456789012:view/My-Resources-View/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111

Exportar resultados da pesquisa para um arquivo.csv

Você pode exportar os resultados de uma consulta de pesquisa de recurso para um arquivo de valores separados por vírgulas (.csv). O arquivo .csv inclui o identificador, o tipo de recurso, a região, a Conta da AWS, o número total de tags e uma coluna para cada chave de tag exclusiva no conjunto. O arquivo .csv pode ajudar a configurar os recursos da AWS na sua organização ou a determinar onde há sobreposições ou inconsistências na marcação entre recursos.

  1. Nos resultados da consulta Pesquisa de recurso, escolha Exportar recursos para CSV.

    Você pode escolher exportar os resultados apenas com as colunas que pode ver no momento ou com todas as colunas disponíveis.

    Resultados da consulta Pesquisa de recurso com o botão de comando Exportar 1.000 recursos para CSV com opções para exportar as colunas visíveis ou exportar todas as colunas mostradas no canto superior direito da tabela Recursos.
  2. Quando solicitado pelo navegador, escolha abrir o arquivo .csv ou salvá-lo em um local conveniente.