Listar e filtrar seus recursos - Amazon Elastic Compute Cloud

Listar e filtrar seus recursos

Você pode obter uma lista de alguns tipos de recursos usando o console do Amazon EC2. Você pode 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

Você pode 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. Escolha um valor de filtro.

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

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

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 valores possíveis para o atributo selecionado é exibida.

  3. Selecione stopped (interrompido) na lista.

Você pode 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.

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. Escolha Instance state (client) (Estado da instância (cliente)). A pesquisa inversa é suportada somente em filtros de cliente.

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

  3. Insira ! (ponto de exclamação) para exibir os filtros inversos.

  4. Escolha !terminated (!encerrado) na lista.

Para filtrar instâncias com base em um atributo de estado de instância, você também pode 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, pesquise pelo atributo Security group name (Nome do grupo de segurança) e, em palavra-chave, insira !launch-wizard-1.

Pesquisa parcial

Com pesquisas parciais, você pode procurar valores de string parciais. Para realizar uma pesquisa parcial, insira apenas uma parte da palavra-chave que você 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.

nota

A pesquisa parcial é 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 de expressão regular

Para usar pesquisas de expressão regular, você deve habilitar Use regular expression matching (Usar correspondência de expressão regular) nas 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]+.*. As pesquisas de expressão regular não diferenciam maiúsculas e minúsculas.

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 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 seguintes valores: prod, prods e production; "prod*" corresponde a todos os valores, enquanto "prod?" corresponde apenas a prod e prods. Para usar os valores literais, coloque uma barra invertida (\) antes e depois deles. Por exemplo, "prod\*" corresponderia a prod*.

nota

A pesquisa por curinga é compatível apenas com pesquisas de atributos em filtros de API. Não é compatível com pesquisas de palavras-chave e pesquisas de atributos somente 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, 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.

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, você pode 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.

Você pode 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, você pode 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

  • Você pode especificar vários filtros e vários valores de filtro em uma única solicitação.

  • Você também pode 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. Você pode 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.

Você pode 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

Você pode 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” seguido 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, você pode 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.