Listar e filtrar seus recursos - Amazon Elastic Compute Cloud

Listar e filtrar seus recursos

É possível obter uma lista de alguns tipos de recursos usando o console do Amazon EC2. É possível obter uma lista de cada tipo de recurso usando seu comando ou ação de API correspondente. Se você tiver muitos recursos, é possível filtrar os resultados para incluir ou excluir somente aqueles que correspondem a determinados critérios.

Listar e filtrar recursos usando o console

Listar recursos usando o console

É possível visualizar os tipos de recurso do Amazon EC2 mais comuns usando o console. Para ver os recursos adicionais, use a interface de linha de comando ou as ações de API.

Para listar os recursos do EC2 usando o console

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. No painel de navegação, escolha a opção que corresponde ao tipo de recurso. Por exemplo, para listar suas instâncias, escolha Instances (Instâncias).

    A página exibe todos os recursos do tipo de recurso selecionado.

Filtrar recursos usando o console

Para filtrar uma lista de recursos

  1. No painel de navegação, selecione um tipo de recurso (por exemplo, Instâncias).

  2. Escolha o campo de pesquisa.

  3. Escolha o filtro na lista.

  4. Selecione um operador, por exemplo,= (Igual a). Alguns atributos têm mais operadores disponíveis para selecionar. Observe que nem todas as telas suportam a seleção de um operador.

  5. Selecione um valor de filtro.

  6. Para editar um filtro selecionado, escolha o token de filtro (caixa azul), faça as edições necessárias e escolha Apply (Aplicar). Observe que nem todas as telas suportam a edição do filtro selecionado.

    
							Edite um filtro.
  7. Quando terminar, remova o filtro.

A funcionalidade de pesquisa e filtro difere ligeiramente entre o console do Amazon EC2 antigo e o novo.

O novo console oferece suporte a dois tipos de filtragem.

  • A filtragem de API acontece no lado do servidor. A filtragem é aplicada na chamada de API, o que reduz o número de recursos retornados pelo servidor. Isso permite a filtragem rápida em grandes conjuntos de recursos e pode reduzir o tempo e o custo de transferência de dados entre o servidor e o navegador. A filtragem de API oferece suporte a operadores = (igual a) e : (contém), e sempre diferencia maiúsculas de minúsculas.

  • A filtragem do cliente acontece no lado do cliente. Isso permite filtrar dados que já estão disponíveis no navegador (em outras palavras, dados que já foram retornados pela API). A filtragem do cliente funciona bem em conjunto com um filtro de API para filtrar para conjuntos de dados menores no navegador. Além dos operadores = (igual a) e : (contém), a filtragem de clientes também pode oferecer suporte a operadores de intervalo, como >= (maior que ou igual a) e operadores de negação (inversa), como ! = (não igual a).

O novo console do Amazon EC2 é compatível com os seguintes tipos de pesquisa:

Pesquisa por palavra-chave

A pesquisa por palavra-chave é uma pesquisa de texto livre que permite pesquisar um valor em todos os atributos ou tags de seus recursos, sem especificar um atributo a ser pesquisado.

nota

Todas as pesquisas por palavras-chave usam filtragem do cliente.

Para pesquisar por palavra-chave, insira ou cole o que você procura na caixa de pesquisa e selecione Enter. Por exemplo, procurar por 123 corresponde a todas as instâncias que tenham 123 em qualquer um de seus atributos, como um endereço IP, ID de instância, ID de VPC ou ID de AMI, ou em qualquer uma de suas tags, como em Name (Nome). Se sua pesquisa de texto livre retornar correspondências inesperadas, aplique filtros adicionais.

Pesquisar por atributo

A pesquisa por um atributo permite que você pesquise um atributo específico em todos os recursos.

nota

As pesquisas de atributos usam filtragem de API ou filtragem de cliente, dependendo do atributo selecionado. Ao realizar uma pesquisa de atributo, os atributos são agrupados conforme necessário.

Por exemplo, é possível pesquisar o atributo Instance state (Estado da instância) para todas as instâncias para retornar apenas instâncias que estão no estado stopped. Para fazer isso:

  1. No campo de pesquisa na tela Instances (Instâncias), comece inserindo Instance state. À medida que você insere os caracteres, os dois tipos de filtros aparecem para Instance state (Estado da instância): API filters (Filtros de API) e Client filters (Filtros de cliente).

  2. Para pesquisar no lado do servidor, escolha Instance state (Estado da instância) em API filters (Filtros de API). Para pesquisar no lado do cliente, escolha Instance state (client) (Estado da instância (cliente)) em Client filters (Filtros de cliente).

    Uma lista de operadores possíveis para o atributo selecionado é exibida.

  3. Selecione o operador = (igual a).

    Uma lista de valores possíveis para o atributo e operador selecionado é exibida.

  4. Selecione stopped (interrompido) na lista.

Pesquisar por etiqueta

A pesquisa por uma tag permite filtrar os recursos na tabela exibida atualmente por uma chave de tag ou um valor de tag.

Pesquisas de tags usam filtragem de APIs ou filtragem de clientes, dependendo das configurações na janela Preferences (Preferências).

Para garantir a filtragem de APIs para tags

  1. Abra a janela Preferences (Preferências).

  2. Limpe a caixa de seleção Use regular expression matching (Usar correspondência de expressões regulares). Se essa caixa de seleção estiver marcada, a filtragem do cliente será executada.

  3. Marque a caixa de seleção Use case sensitive matching (Usar correspondência com distinção de maiúsculas e minúsculas). Se essa caixa de seleção estiver desmarcada, a filtragem do cliente será executada.

  4. Selecione a opção Confirm (Confirmar).

Ao pesquisar por tag, é possível usar os seguintes valores:

  • (empty) (vazio): encontra todos os recursos com a chave de tag especificada, mas não deve haver valor de tag.

  • All values (Todos os valores): encontra todos os recursos com a chave de tag especificada e qualquer valor de tag.

  • Not tagged (Sem tag aplicada): pesquisa por todos os recursos que não tenham uma determinada chave de tag.

  • O valor exibido: encontra todos os recursos com a chave de tag especificada e o valor da tag especificado.

É possível usar as seguintes técnicas para aprimorar ou refinar suas pesquisas:

Pesquisa inversa

Pesquisas inversas permitem pesquisar recursos que não correspondem a um valor especificado. Nas telas Instances (Instâncias) e AMIs, as pesquisas inversas são realizadas selecionando o operador != (Não igual a) ou !: (Não contém) e, em seguida, selecionando um valor. Nas outras telas, as pesquisas inversas são realizadas colocando o caractere de ponto de exclamação (!) como prefixo da palavra-chave de pesquisa.

nota

A pesquisa inversa é compatível com pesquisas de palavras-chave e pesquisas de atributos somente em filtros de cliente. Ela não é compatível com pesquisas de atributos em filtros de API.

Por exemplo, é possível pesquisar o atributo Instance state (Estado da instância) para todas as instâncias a fim de excluir todas as instâncias que estão no estado terminated. Para fazer isso:

  1. No campo de pesquisa na tela Instances (Instâncias), comece inserindo Instance state. À medida que você insere os caracteres, os dois tipos de filtros aparecem para Instance state (Estado da instância): API filters (Filtros de API) e Client filters (Filtros de cliente).

  2. Em Client filters (Filtros de cliente), escolha Instance state (client) (Estado da instância, cliente). A pesquisa inversa é aceita somente em filtros de cliente.

    Uma lista de operadores possíveis para o atributo selecionado é exibida.

  3. Selecione != (Não igual a) e, em seguida, escolha terminated (terminado).

Para filtrar instâncias com base em um atributo de estado de instância, também é possível usar os ícones de pesquisa ( ) na coluna Instance state (Estado da instância). O ícone de pesquisa com um sinal de mais (+) exibe todas as instâncias que correspondem a esse atributo. O ícone de pesquisa com um sinal de menos (-) exclui todas as instâncias que correspondem a esse atributo.

Aqui está outro exemplo de uso da pesquisa inversa: listar todas as instâncias que não são atribuídas ao grupo de segurança chamado launch-wizard-1. Em Client filters (Filtros do cliente), pesquise pelo atributo Security group name (Nome do grupo de segurança), escolha != e, na barra de pesquisa, insira launch-wizard-1.

Pesquisa parcial

Com pesquisas parciais, é possível procurar valores de string parciais. Para realizar uma pesquisa parcial, insira apenas uma parte da palavra-chave que você deseja pesquisar. Nas telas Instances (Instâncias) e AMIs, as pesquisas parciais só podem ser realizadas com o operador : (Contém). Em outras telas, é possível selecionar o atributo de filtro do cliente e inserir imediatamente apenas uma parte da palavra-chave que deseja pesquisar. Por exemplo, na tela Instance type (Tipo de instância), para pesquisar todas as instâncias t2.micro, t2.small e t2.medium, pesquise pelo atributo Instance Type (Tipo de instância) e, para a palavra-chave, insira t2.

Pesquisa de expressão regular

Para usar pesquisas de expressão regular, é necessário marcar a caixa de seleção Use regular expression matching (Usar correspondência de expressão regular) na janela Preferences (Preferências).

As expressões regulares são úteis quando você precisa corresponder os valores de um campo com um padrão específico. Por exemplo, para procurar um valor que comece com s, procure ^s. Para procurar um valor que termine com xyz, procure xyz$. Ou para procurar um valor que começa com um número seguido por um ou mais caracteres, procure [0-9]+.*.

nota

A pesquisa de expressão regular é compatível com pesquisas de palavras-chave e pesquisas de atributos somente em filtros de cliente. Ela não é compatível com pesquisas de atributos em filtros de API.

Pesquisa com diferenciação de maiúsculas e minúsculas

Para fazer pesquisas que diferenciem maiúsculas de minúsculas, é necessário marcar a caixa de seleção Use case sensitive matching (Usar correspondência com distinção de maiúsculas e minúsculas) na janela Preferences (Preferências). A preferência com diferenciação de maiúsculas e minúsculas se aplica somente aos filtros de cliente e tag.

nota

Os filtros de API sempre diferenciam maiúsculas de minúsculas.

Pesquisa por curinga

Use o curinga * para corresponder a zero ou mais caracteres. Use o curinga ? para corresponder a zero ou um caractere. Por exemplo, se você tiver um conjunto de dados com os valores prod, prods, e production, uma pesquisa por prod* corresponde a todos os valores, enquanto prod? corresponde somente a prod e prods. Para usar os valores literais, coloque uma barra invertida (\) antes. Por exemplo, "prod\*" corresponderia a prod*.

nota

A pesquisa por curingas é compatível apenas com pesquisas de atributos e tags em filtros de API. Não é compatível com pesquisas de palavras-chave e pesquisas de atributos e tags em filtros de cliente.

Combinar pesquisas

Em geral, vários filtros com o mesmo atributo são unidos automaticamente com OR. Por exemplo, pesquisar Instance State : Running e Instance State : Stopped retorna todas as instâncias que estão em execução OU interrompidas. Para unir a pesquisa com AND, pesquise em diferentes atributos. Por exemplo, pesquisar Instance State : Running e Instance Type : c4.large retorna apenas instâncias que são do tipo c4.large E que estão no estado de execução.

O antigo console do Amazon EC2 é compatível com os seguintes tipos de pesquisa:

Pesquisa por palavra-chave

Pesquisa por palavra-chave é uma pesquisa de texto livre que permite que você procure um valor em todos os atributos de seus recursos. Para pesquisar por palavra-chave, insira ou cole o que você procura na caixa de pesquisa e selecione Enter. Por exemplo, procurar 123 corresponde a todas as instâncias que têm 123 em qualquer um de seus atributos, como um endereço IP, ID de instância, ID de VPC ou ID de AMI. Se sua pesquisa de texto livre retornar correspondências inesperadas, aplique filtros adicionais.

Pesquisar por atributos

A pesquisa por um atributo permite que você pesquise um atributo específico em todos os recursos. Por exemplo, é possível pesquisar o atributo Estado para todas as instâncias para retornar apenas instâncias que estão no estado stopped. Para fazer isso:

  1. No campo de pesquisa na tela Instances (Instâncias), comece inserindo Instance State. À medida que você insere caracteres, uma lista de atributos correspondentes é exibida.

  2. Selecione Instance State (Estado da instância) na lista. Uma lista de valores possíveis para o atributo selecionado é exibida.

  3. Selecione Stopped (Parado) na lista.

É possível usar as seguintes técnicas para aprimorar ou refinar suas pesquisas:

Pesquisa inversa

Pesquisas inversas permitem pesquisar recursos que não correspondem a um valor especificado. Pesquisas inversas são realizadas colocando o caractere de ponto de exclamação (!) como prefixo da palavra-chave de pesquisa. Por exemplo, para listar todas as instâncias que não foram encerradas, pesquise pelo atributo Instance State (Estado da instância) e, para a palavra-chave, insira !Terminated.

Pesquisa parcial

Com pesquisas parciais, é possível procurar valores de string parciais. Para realizar uma pesquisa parcial, insira apenas uma parte da palavra-chave que deseja pesquisar. Por exemplo, para pesquisar todas as instâncias t2.micro, t2.small e t2.medium, pesquise pelo atributo Instance Type (Tipo de instância) e, para a palavra-chave, insira t2.

Pesquisa de expressão regular

As expressões regulares são úteis quando você precisa corresponder os valores de um campo com um padrão específico. Por exemplo, para pesquisar todas as instâncias que têm um valor de atributo que começa com s, procure ^s. Ou para procurar todas as instâncias que têm um valor de atributo que termina com xyz, procure xyz$. As pesquisas de expressão regular não diferenciam maiúsculas e minúsculas.

Combinar pesquisas

Em geral, vários filtros com o mesmo atributo são unidos automaticamente com OR. Por exemplo, pesquisar Instance State : Running e Instance State : Stopped retorna todas as instâncias que estão em execução OU interrompidas. Para unir a pesquisa com AND, pesquise em diferentes atributos. Por exemplo, procurar Instance State : Running e Instance Type : c4.large retorna apenas instâncias que são do tipo c4.large E que estão no estado parado.

Listar e filtrar usando a CLI e a API

Cada tipo de recurso tem um comando da CLI correspondente e ação de API que você usa para listar os recursos desse tipo. As listas de recursos resultantes podem ser longas, portanto, pode ser mais rápido e mais útil filtrar os resultados para incluir apenas os recursos que correspondem a critérios específicos.

Considerações sobre filtragem

  • É possível especificar vários filtros e vários valores de filtro em uma única solicitação.

  • Também é possível usar caracteres curinga com os valores de filtro. Um asterisco (*) corresponde a zero ou mais caracteres, e um ponto de interrogação (?) corresponde a zero ou um caractere.

  • Os valores do filtro diferenciam maiúsculas de minúsculas.

  • Sua pesquisa pode incluir os valores literais dos caracteres curinga; apenas só precisa recuá-los uma barra invertida antes do caractere. Por exemplo, um valor \*amazon\?\\ pesquisa pela string literal, *amazon?\.

Filtros compatíveis

Para ver os filtros compatíveis com cada recurso do Amazon EC2, consulte a documentação a seguir:

exemplo Exemplo: Especificar um único filtro

É possível listar suas instâncias do Amazon EC2 usando describe-instances. Sem filtros, a resposta contém informações de todos os recursos. É possível usar o seguinte comando para incluir apenas as instâncias em execução em sua saída.

aws ec2 describe-instances --filters Name=instance-state-name,Values=running

Para listar apenas os IDs de suas instâncias em execução, adicione o parâmetro --query da seguinte maneira.

aws ec2 describe-instances --filters Name=instance-state-name,Values=running --query "Reservations[*].Instances[*].InstanceId" --output text

A seguir está um exemplo de saída.

i-0ef1f57f78d4775a4 i-0626d4edd54f1286d i-04a636d18e83cfacb

exemplo Exemplo: Especificar vários filtros ou valores de filtro

Se você especificar vários filtros ou vários valores de filtro, o recurso deverá corresponder a todos os filtros a serem incluídos nos resultados.

É possível usar o seguinte comando para listar todas as instâncias cujo tipo é m5.large ou m5d.large.

aws ec2 describe-instances --filters Name=instance-type,Values=m5.large,m5d.large

É possível usar o seguinte comando para listar todas as instâncias paradas cujo tipo é t2.micro.

aws ec2 describe-instances --filters Name=instance-state-name,Values=stopped Name=instance-type,Values=t2.micro

exemplo Exemplo: Usar curingas em um valor de filtro

Se você especificar database como o valor do filtro description ao descrever snapshots do EBS usando describe-snapshots, o comando retornará somente os snapshots cuja descrição é “banco de dados”.

aws ec2 describe-snapshots --filters Name=description,Values=database

O curinga * corresponde a zero ou mais caracteres. Se você especificar *database* como o valor do filtro, o comando retornará apenas snapshots cuja descrição inclui a palavra banco de dados.

aws ec2 describe-snapshots --filters Name=description,Values=*database*

O curinga ? corresponde exatamente a 1 caractere. Se você especificar database? como o valor do filtro, o comando retornará apenas snapshots cuja descrição é “banco de dados” ou “banco de dados” seguido por um caractere.

aws ec2 describe-snapshots --filters Name=description,Values=database?

Se você especificar database????, o comando retornará apenas snapshots cuja descrição é “banco de dados” seguida de até quatro caracteres. Ele exclui descrições com “banco de dados” seguido por cinco ou mais caracteres.

aws ec2 describe-snapshots --filters Name=description,Values=database????

exemplo Exemplo: filtro baseado em data

Com a AWS CLI, é possível usar JMESPath para filtrar resultados usando expressões. Por exemplo, o comando describe-snapshots a seguir exibe os IDs de todos os snapshots criados pela sua conta da AWS(representada por 123456789012) antes da data especificada (representada por 31/3/2020). Se você não especificar o proprietário, os resultados incluirão todos os snapshots públicos.

aws ec2 describe-snapshots --filters Name=owner-id,Values=123456789012 --query "Snapshots[?(StartTime<='2020-03-31')].[SnapshotId]" --output text

O comando a seguir exibe os IDs de todos os snapshots criados no intervalo de datas especificado.

aws ec2 describe-snapshots --filters Name=owner-id,Values=123456789012 --query "Snapshots[?(StartTime>='2019-01-01') && (StartTime<='2019-12-31')].[SnapshotId]" --output text

Filtrar com base em tags

Para obter exemplos de como filtrar uma lista de recursos de acordo com suas tags, consulte Trabalhar com tags usando a linha de comando.

Listar e filtrar recursos entre regiões usando o Amazon EC2 Global View

O Amazon EC2 Global View permite que você visualize alguns de seus recursos do Amazon EC2 e do Amazon VPC em uma única região da AWS ou em várias regiões em um único console. Usando o Amazon EC2 Global View, é possível visualizar um resumo de todas as suas VPCs, sub-redes, instâncias, grupos de segurança e volumes em todas as regiões para as quais sua conta AWS está habilitada. O Amazon EC2 Global View também fornece a funcionalidade pesquisa global, que permite pesquisar recursos específicos ou tipos de recursos específicos em várias regiões simultaneamente.

O Amazon EC2 Global View não permite que você modifique recursos de forma alguma.

Permissões obrigatórias

Um usuário do IAM deve ter as seguintes permissões para usar o Amazon EC2 Global View.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:DescribeVpcs", "ec2:DescribeRegions", "ec2:DescribeVolumes", "ec2:DescribeSubnets", "ec2:DescribeSecurityGroups" ], "Resource": "*" }] }

Para usar o Amazon EC2 Global View

Abra o console do Amazon EC2 Global View em https://console.aws.amazon.com/ec2globalview/home.

O console consiste em duas abas:

  • Explorador de região: essa aba inclui as seções a seguir:

    • Resumo do recurso: fornece uma visão geral de alto nível dos recursos em todas as regiões.

      Regiões habilitadas indica o número de regiões para as quais sua conta AWS está habilitada. Os campos restantes indicam o número de recursos que você tem atualmente nessas regiões. Escolha qualquer um dos links para visualizar os recursos desse tipo em todas as regiões. Por exemplo, se o link abaixo do rótulo Instâncias for 29 em 10 regiões, ele indica que você tem 29 instâncias em 10 regiões. Escolha o link para visualizar uma lista de todas as 29 instâncias.

    • Contagens de recursos por região: lista todas as regiões AWS (incluindo aquelas para as quais sua conta não está habilitada) e fornece o número total para cada tipo de recurso para cada região.

      Escolha um nome de região para visualizar todos os recursos de todos os tipos para essa região específica. Por exemplo, escolha África (Cidade do Cabo) af-south-1 para visualizar todas as VPCs, sub-redes, instâncias, grupos de segurança e volumes nessa região. Como alternativa, selecione uma região e escolha Exibir recursos para a região selecionada.

      Escolha o valor para um tipo de recurso específico em uma região específica para visualizar somente os recursos desse tipo nessa região. Por exemplo, escolha o valor para Instâncias para África (Cidade do Cabo) af-south-1 para visualizar somente as instâncias nessa região.

  • Pesquisa global: essa guia permite que você pesquise recursos específicos ou tipos de recursos específicos em uma única região ou em várias regiões. Ela também permite que você veja detalhes de um recurso específico.

    Para pesquisar recursos, insira os critérios de pesquisa no campo anterior à grade. É possível pesquisar por região, por tipo de recurso e pelas etiquetas atribuídas aos recursos.

    Para visualizar os detalhes de um recurso específico, selecione-o na grade. Também é possível escolher o ID de recurso para abrir o recurso no respectivo console. Por exemplo, escolha um ID de instância para abrir a instância no console do Amazon EC2 ou escolha um ID de sub-rede para abrir a sub-rede no console da Amazon VPC.