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

# Marcar uma regra de retenção da Lixeira
<a name="recycle-bin-tag-resource"></a>

É possível atribuir tags personalizadas às regras de retenção para categorizá-las de diferentes maneiras, por exemplo, por objetivo, proprietário ou ambiente. Isso ajuda a localizar de forma eficiente uma regra de retenção específica com base nas etiquetas personalizadas que foram atribuídas.

É possível atribuir uma tag a uma regra de retenção usando um dos métodos a seguir.

------
#### [ Recycle Bin console ]

**Para aplicar tag em uma regra de retenção**

1. [Abra o console da Lixeira em casa/ https://console.aws.amazon.com/rbin/](https://console.aws.amazon.com/rbin/home/)

1. No painel de navegação, selecione **Retention rules** (Regras de retenção).

1. Selecione a regra de retenção para aplicar tag, escolha a guia **Tags**, e depois, escolha **Manage tags** (Gerenciar tags).

1. Escolha **Adicionar Tag**. Em **Key** (Chave), insira o nome da chave. Em **Value** (Valor), insira o valor da tag.

1. Escolha **Save** (Salvar).

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

**Para aplicar tag em uma regra de retenção**  
Use o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/rbin/tag-resource.html) AWS CLI . Em `--resource-arn`, especifique o nome do recurso da Amazon (ARN) da regra de retenção a aplicar tag e, para `--tags`, especifique o par de chave e valor da tag.

```
aws rbin tag-resource \
--resource-arn {{retention_rule_arn}} \
--tags key={{tag_key}},value={{tag_value}}
```

**Exemplo**  
O exemplo de comando a seguir marca a regra de retenção `arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3` com a tag `purpose=production`.

```
aws rbin tag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tags key=purpose,value=production
```

------

## Exibir etiquetas de regras de retenção
<a name="recycle-bin-view-resource-tag"></a>

É possível visualizar as tags atribuídas a uma regra de retenção usando um dos métodos a seguir.

------
#### [ Recycle Bin console ]

**Para visualizar as tags para uma regra de retenção**

1. [Abra o console da Lixeira em casa/ https://console.aws.amazon.com/rbin/](https://console.aws.amazon.com/rbin/home/)

1. No painel de navegação, selecione **Retention rules** (Regras de retenção).

1. Selecione a regra de retenção para a qual deseja visualizar as etiquetas e escolha a guia **Tags** (Etiquetas).

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

**Para visualizar as tags atribuídas a uma regra de retenção**  
Use o comando [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/rbin/list-tags-for-resource.html). AWS CLI Em `--resource-arn`, especifique o ARN da regra de retenção.

```
aws rbin list-tags-for-resource \
--resource-arn {{retention_rule_arn}}
```

**Exemplo**  
O exemplo de comando a seguir lista as tags da regra de retenção `arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3`.

```
aws rbin list-tags-for-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
```

------

## Remover etiquetas de uma regra de retenção
<a name="recycle-bin-untag-resource"></a>

É possível remover tags de uma regra de retenção usando um dos métodos a seguir.

------
#### [ Recycle Bin console ]

**Para remover uma tag de uma regra de retenção**

1. [Abra o console da Lixeira em casa/ https://console.aws.amazon.com/rbin/](https://console.aws.amazon.com/rbin/home/)

1. No painel de navegação, selecione **Retention rules** (Regras de retenção).

1. Selecione a regra de retenção da qual deseja remover a tag , escolha a guia **Tags** e, em seguida, escolha **Manage tags** (Gerenciar tags).

1. Escolha **Remove** (Remover) ao lado da tag a ser removida.

1. Escolha **Save** (Salvar).

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

**Para remover uma tag de uma regra de retenção**  
Use o comando [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/rbin/untag-resource.html) da AWS CLI . Em `--resource-arn`, especifique o ARN da regra de retenção. Em `--tagkeys`, especifique as chaves de tag das tags a serem removidas.

```
aws rbin untag-resource \
--resource-arn {{retention_rule_arn}} \
--tagkeys {{tag_key}}
```

**Exemplo**  
O exemplo de comando a seguir remove as tags que têm uma chave de tag de `purpose` da regra de retenção `arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3`.

```
aws rbin untag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tagkeys purpose
```

------