

# Filtrar recursos do Amazon EC2 por tag
<a name="filtering-the-list-by-tag"></a>

Depois de adicionar tags, você pode filtrar os recursos do Amazon EC2 com base em chaves e valores de tags.

------
#### [ Console ]

**Para filtrar recursos por tag**

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

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

1. Escolha o campo de pesquisa.

1. Na lista, em **Tags**, escolha a chave da tag.

1. Escolha o valor de tag correspondente na lista.

1. Quando terminar, remova o filtro.

Para obter mais informações sobre o uso de filtros no console do Amazon EC2, consulte [Encontrar seus recursos do Amazon EC2](Using_Filtering.md).

------
#### [ AWS CLI ]

**Para descrever recursos de um único tipo com a chave de tag especificada**  
Adicione o seguinte filtro a um comando `describe` para descrever os recursos desse tipo com uma tag Stack, independentemente do valor da tag.

```
--filters Name=tag-key,Values={{Stack}}
```

**Para descrever recursos de um único tipo com a tag especificada**  
Adicione o seguinte filtro a um comando `describe` para descrever os recursos desse tipo com a tag Stack=production.

```
--filters Name=tag:{{Stack}},Values={{production}}
```

**Para descrever recursos de um único tipo com o valor de tag especificado**  
Adicione o seguinte filtro a um comando `describe` para descrever os recursos desse tipo com uma tag com o valor production, independentemente da chave da tag.

```
--filters Name=tag-value,Values={{production}}
```

**Para descrever todos os recursos do EC2 com a tag especificada**  
Adicione o seguinte filtro ao comando [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html) para descrever todos os recursos do EC2 com a tag Stack=test.

```
--filters Name=key,Values={{Stack}} Name=value,Values={{test}}
```

------
#### [ PowerShell ]

**Para filtrar recursos de um único tipo por chave de tag**  
Adicione o seguinte filtro a um cmdlet `Get` para descrever os recursos desse tipo com uma tag Stack, independentemente do valor da tag.

```
-Filter @{Name="tag-key"; Values="{{Stack}}"}
```

**Para filtrar recursos de um único tipo por tag**  
Adicione o seguinte filtro a um cmdlet `Get` para descrever os recursos desse tipo com a tag Stack=production.

```
-Filter @{Name="tag:{{Stack}}"; Values="{{production}}"}
```

**Para filtrar recursos de um único tipo por valor de tag**  
Adicione o seguinte filtro a um cmdlet `Get` para descrever os recursos desse tipo com uma tag com o valor production, independentemente do valor da tag.

```
-Filter @{Name="tag-value"; Values="{{production}}"}
```

**Para filtrar todos os recursos do EC2 por tag**  
Adicione o seguinte filtro ao cmdlet [Get-EC2Tag](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Tag.html) para descrever todos os recursos do EC2 com a tag Stack=test.

```
-Filter @{Name="tag:{{Stack}}"; Values="{{test}}"}
```

------