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

# **eb tags**
<a name="eb3-tags"></a>

## Description
<a name="eb3-tagsdescription"></a>

Adicione, exclua, atualize e liste tags de um recurso do Elastic Beanstalk.

Para obter detalhes sobre a marcação de recursos no Elastic Beanstalk, consulte [Marcar recursos da aplicação do Elastic Beanstalk](applications-tagging-resources.md).

## Sintaxe
<a name="eb3-tagsyntax"></a>

**eb tags [{{environment-name}}] [--resource {{ARN}}] -l \| --list**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -a \| --add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -u \| --update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -d \| --delete {{key1}}[,{{key2}} ...]**

Você pode combinar as opções de subcomando `--add`, `--update` e `--delete` em um único comando. Pelo menos uma delas é necessária. Você não pode combinar nenhuma dessas três opções de subcomando com `--list`.

Sem nenhum argumento adicional, todos esses comandos listam ou modificam tags do ambiente padrão no aplicativo do diretório atual. Com um {{environment-name}} argumento, os comandos listam ou modificam as tags desse ambiente. Com a opção `--resource`, os comandos listam ou modificam as tags de qualquer recurso do Elastic Beanstalk: uma aplicação, um ambiente, uma versão da aplicação, uma configuração salva ou uma versão da plataforma personalizada. Especifique o recurso pelo seu nome de recurso da Amazon (ARN).

## Opções
<a name="eb3-tagsoptions"></a>

Nenhuma dessas opções é obrigatória. Se você executar **eb create** sem opções, será solicitado a inserir ou selecionar um valor para cada configuração.


****  

|  Nome  |  Descrição  | 
| --- | --- | 
| `-l`<br />ou<br />`--list` | Listar todas as tags que estão sendo aplicadas no recurso atualmente. | 
| `-a {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />ou<br />`--add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | Aplique novas tags no recurso. Especifique as tags como uma lista de `key=value` separados por vírgulas. Não é possível especificar chaves de tags existentes.<br />Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). | 
| `-u {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />ou<br />`--update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | Atualize os valores de tags de recursos existentes. Especifique as tags como uma lista de `key=value` separados por vírgulas. Você precisa especificar chaves de tags existentes.<br />Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). | 
| `-d {{key1}}[,{{key2}} ...]`<br />ou<br />`--delete {{key1}}[,{{key2}} ...]` | Exclua as tags de recursos existentes. Especifique as tags como uma lista de chaves separados por vírgulas. Você precisa especificar chaves de tags existentes.<br />Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). | 
| `-r` {{region}}<br />or<br />`--region` {{region}} | O Região da AWS em que seu recurso existe.<br />Padronizado: a região padrão configurada.<br />Para obter a lista de valores que você pode especificar para essa opção, consulte [Endpoints e cotas do AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) no *Referência geral da AWS*. | 
| `--resource {{ARN}}` | O ARN do recurso para o qual o comando modifica ou lista tags. Se não for especificado, o comando refere-se ao ambiente (padrão ou especificado) no aplicativo do diretório atual.<br />Valores válidos: consulte um dos subtópicos de [Marcar recursos](applications-tagging-resources.md) específico do recurso de interesse. Esses tópicos mostram como o ARN do recurso é construído e explicam como obter uma lista dos recursos existentes para seu aplicativo ou conta. ARNs  | 

## Output
<a name="eb3-tagsoutput"></a>

A opção de subcomando de `--list` exibe uma lista das tags de recursos. A saída mostra as tags que o Elastic Beanstalk aplica por padrão e suas tags personalizadas.

```
$ eb tags --list
Showing tags for environment 'MyApp-env':

Key                                 Value

Name                                MyApp-env
elasticbeanstalk:environment-id     e-63cmxwjaut
elasticbeanstalk:environment-name   MyApp-env
mytag                               tagvalue
tag2                                2nd value
```

As opções de subcomando `--add`, `--update` e `--delete`, quando bem-sucedidas, não têm nenhuma saída. Você pode adicionar a opção `--verbose` para ver saída detalhada da atividade do comando.

```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:

Key                                 Value

mytag                               tag value
```

## Exemplos
<a name="eb3-tagsexamples"></a>

O comando a seguir adiciona uma tag com êxito com a chave `tag1` e o valor `value1` ao ambiente padrão do aplicativo e, ao mesmo tempo, exclui a tag `tag2`.

```
$ eb tags --add tag1=value1 --delete tag2
```

O comando a seguir adiciona uma tag com êxito a uma configuração salva em um aplicativo.

```
$ eb tags --add tag1=value1 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:{{my-account-id}}:configurationtemplate/{{my-app}}/{{my-template}}"
```

O comando a seguir falha porque ele tenta atualizar uma tag não existente.

```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:

  tag3
```

O comando a seguir falha porque ele tenta atualizar e excluir a mesma chave.

```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```