

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

# Atribuir tags em versões do aplicativo
<a name="applications-versions-tagging"></a>

Este tópico explica os benefícios de marcar as versões da aplicação Elastic Beanstalk e como gerenciar as etiquetas.

Você pode aplicar tags às versões do seu AWS Elastic Beanstalk aplicativo. 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).

Você pode especificar tags quando criar uma versão do aplicativo. Em uma versão de aplicativo existente, você pode adicionar ou remover tags e atualizar os valores de tags existentes. Você pode adicionar até 50 tags para cada versão do aplicativo.

## Adicionar tags durante a criação da versão do aplicativo
<a name="applications-versions-tagging.create"></a>

Ao usar o console do Elastic Beanstalk para [criar um ambiente](environments-create-wizard.md) e optar por fazer upload de uma versão do código da aplicação, você pode especificar chaves e valores de tags para associar à nova versão da aplicação.

Também é possível usar o console do Elastic Beanstalk para [fazer upload de uma versão da aplicação](applications-versions.md) sem usá-lo imediatamente em um ambiente. Você pode especificar valores e chaves de tag ao carregar uma versão do aplicativo.

Com o AWS CLI ou outros clientes baseados em API, adicione tags usando o `--tags` parâmetro no **[create-application-version](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-application-version.html)** comando.

```
$ aws elasticbeanstalk create-application-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --application-name my-app --version-label v1
```

Quando você usa a CLI do EB para criar ou atualizar um ambiente, uma versão do aplicativo é criada a partir do código implementado. Não há uma maneira direta de atribuir uma tag a uma versão do aplicativo durante sua criação por meio da CLI do EB. Consulte a seção a seguir para saber como adicionar tags a uma versão do aplicativo existente.

## Gerenciar tags de uma versão do aplicativo existente
<a name="applications-versions-tagging.manage"></a>

É possível adicionar, atualizar e excluir tags em uma versão existente da aplicação do Elastic Beanstalk.

**Como gerenciar as tags de uma versão da aplicação usando o 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 **Aplicativos** e escolha o nome do aplicativo na lista.

1. No painel de navegação, encontre o nome do aplicativo e escolha **Application versions (Versões do aplicativo)**.

1. Selecione a versão do aplicativo que você deseja gerenciar.

1. Escolha **Actions (Ações)** e **Manage tags (Gerenciar tags)**.

1. Use o formulário na tela para adicionar, atualizar ou excluir tags.

1. Para salvar as alterações, escolha **Apply (Aplicar)** na parte inferior da página.

Se você usar a CLI do EB para atualizar a versão do aplicativo, use **[eb tags](eb3-tags.md)** para adicionar, atualizar, excluir ou listar tags.

Por exemplo, o comando a seguir lista as tags em uma versão do aplicativo.

```
~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

O comando a seguir atualiza a tag `mytag1` e exclui a tag `mytag2`.

```
~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

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 uma versão do aplicativo.

```
$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

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 uma versão do aplicação.

```
$ 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:applicationversion/my-app/my-version"
```

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 alguns AWS CLI comandos e CLI do EB com uma versão do aplicativo Elastic Beanstalk, você precisa do ARN da versão do aplicativo. Você pode recuperar o ARN usando o comando a seguir.  

```
$ aws elasticbeanstalk describe-application-versions --application-name my-app --version-label my-version
```