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 \$1 --list**

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

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

**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --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` ou `--list`  |  Listar todas as tags que estão sendo aplicadas no recurso atualmente.  | 
|  `-a key1=value1[,key2=value2 ...]` ou `--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. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md).  | 
|  `-u key1=value1[,key2=value2 ...]` ou `--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. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md).  | 
|  `-d key1[,key2 ...]` ou `--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. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md).  | 
|  `-r` *region* or `--region` *region*  |  O Região da AWS em que seu recurso existe. Padronizado: a região padrão configurada. 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. 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.
```