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 recursos em seus ambientes do Elastic Beanstalk
Você pode aplicar tags aos seus AWS Elastic Beanstalk ambientes. As tags são pares de valores-chave associados AWS aos recursos. Para obter informações sobre a atribuição de tags do recurso do Elastic Beanstalk, casos de uso, restrições de chave e valor de tag, além de tipos de recursos compatíveis, consulte [Marcar recursos da aplicação do Elastic Beanstalk](applications-tagging-resources.md).
O Elastic Beanstalk aplica tags de ambiente ao próprio recurso do ambiente, bem como a outros AWS recursos que o Elastic Beanstalk cria para o ambiente. É possível usar tags para gerenciar permissões no nível de recurso específico em um ambiente. Para obter mais informações, consulte Como [marcar seus EC2 recursos da Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) no *Guia do EC2 usuário da Amazon*.
Por padrão, o Elastic Beanstalk aplica algumas tags ao seu ambiente:
+ `elasticbeanstalk:environment-name`: o nome do ambiente.
+ `elasticbeanstalk:environment-id`: o ID do ambiente.
+ `Name`— Também o nome do ambiente. `Name`é usado no EC2 painel da Amazon para identificar e classificar recursos.
Você não pode editar essas etiquetas padrão.
É possível especificar tags ao criar o ambiente do Elastic Beanstalk. Em um ambiente existente, você pode adicionar ou remover tags e atualizar os valores de tags existentes. Um ambiente pode ter até 50 tags, incluindo as tags padrão.
## Adicionar tags durante a criação do ambiente
Ao usar o console do Elastic Beanstalk para criar um ambiente, é possível especificar chaves e valores de tags na página **Modify tags (Modificar tags)** do assistente [Create New Environment (Criar ambiente)](environments-create-wizard.md).
Se você usar a CLI do EB para criar um ambiente, use a opção `--tags` com **[eb create](eb3-create.md)** para adicionar tags.
```
~/workspace/my-app$ eb create --tags {{mytag1}}={{value1}},{{mytag2}}={{value2}}
```
Com o AWS CLI ou outros clientes baseados em API, use o `--tags` parâmetro no **[create-environment](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-environment.html)** comando.
```
$ aws elasticbeanstalk create-environment \
--tags Key={{mytag1}},Value={{value1}} Key={{mytag2}},Value={{value2}} \
--application-name {{my-app}} --environment-name {{my-env}} --cname-prefix {{my-app}} --version-label {{v1}} --template-name {{my-saved-config}}
```
As [configurações salvas](environment-configuration-methods-before.md#configuration-options-before-savedconfig) incluem as tags definidas pelo usuário. Quando você aplica uma configuração salva que contém tags durante a criação do ambiente, essas tags são aplicadas ao novo ambiente, desde que você não especifique nenhuma tag nova. Se você adicionar tags a um ambiente usando um dos métodos anteriores, qualquer tag definida na configuração salva será descartada.
## Gerenciar tags de um ambiente existente
É possível adicionar, atualizar e excluir tags em um ambiente existente do Elastic Beanstalk. O Elastic Beanstalk aplica as alterações aos recursos do seu ambiente.
No entanto, não é possível editar as tags padrão que o Elastic Beanstalk aplica a seu ambiente.
**Como gerenciar as tags de um ambiente no console do Elastic Beanstalk**
1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS
1. No painel de navegação, selecione **Ambientes** e selecione o nome do ambiente na lista.
1. No painel de navegação, selecione **Tags**.
A página de gerenciamento de tags mostra a lista de tags que existem atualmente no ambiente.
1. Adicione, atualize ou exclua tags:
+ Para adicionar uma tag, insira-a nas caixas vazias na parte inferior da lista. Para adicionar outra tag, escolha **Add tag (Adicionar tag)** e o Elastic Beanstalk adicionará outro par de caixas vazias.
+ Para atualizar uma chave ou valor da tag, edite a caixa respectiva na linha da tag.
+ Para excluir uma tag, escolha **Remove (Remover)** ao lado da caixa de valor da tag.
1. Para salvar as alterações, escolha **Apply (Aplicar)** na parte inferior da página.
Se você usar a CLI do EB para atualizar o ambiente, use **[eb tags](eb3-tags.md)** para adicionar, atualizar, excluir ou listar tags.
Por exemplo, o comando a seguir lista as tags em seu ambiente padrão.
```
~/workspace/my-app$ eb tags --list
```
O comando a seguir atualiza a tag `mytag1` e exclui a tag `mytag2`.
```
~/workspace/my-app$ eb tags --update {{mytag1}}={{newvalue}} --delete {{mytag2}}
```
Para obter uma lista de opções e mais exemplos, consulte `eb tags`.
Com o AWS CLI ou outros clientes baseados em API, use o **[list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/list-tags-for-resource.html)** comando para listar as tags de um ambiente.
```
$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:{{my-account-id}}:environment/{{my-app}}/{{my-env}}"
```
Use o comando **[update-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/update-tags-for-resource.html)** para adicionar, atualizar ou excluir tags em um ambiente.
```
$ aws elasticbeanstalk update-tags-for-resource \
--tags-to-add Key={{mytag1}},Value={{newvalue}} --tags-to-remove {{mytag2}} \
--resource-arn "arn:aws:elasticbeanstalk:us-east-2:{{my-account-id}}:environment/{{my-app}}/{{my-env}}"
```
Especifique as tags a serem adicionadas e atualizadas no parâmetro `--tags-to-add` do **update-tags-for-resource**. Uma tag não existente é adicionada, e o valor de uma tag existente é atualizado.
**nota**
Para usar esses dois AWS CLI comandos com um ambiente do Elastic Beanstalk, você precisa do ARN do ambiente. Você pode recuperar o ARN usando o comando a seguir.
```
$ aws elasticbeanstalk describe-environments
```