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.

Filtros compatíveis

O console do Amazon EC2 é compatível com 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 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 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 ( Search icon. ) 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.

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 até 50 filtros e até 200 valores por filtro em uma única solicitação.

  • As strings do filtro podem ter até 255 caracteres.

  • 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

Você pode 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 2020-03-31). 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.

Visualizar recursos entre regiões usando a Visualização Global do Amazon EC2

A Visualização Global do Amazon EC2 permite que você veja e pesquise recursos do Amazon EC2 e da Amazon VPC em uma única região da AWS ou em várias regiões simultaneamente em um único console. Para ter mais informações, consulte Amazon EC2 Global View.