Marcar recursos em seus ambientes do Elastic Beanstalk

Você pode aplicar tags aos ambientes do AWS Elastic Beanstalk. As tags são pares de chave-valor associados a recursos da AWS. 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.

O Elastic Beanstalk aplica tags de ambiente ao próprio recurso de ambiente, bem como a outros recursos da AWS criados pelo Elastic Beanstalk 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 Marcação de seus recursos do Amazon EC2 no Guia do Usuário do Amazon EC2.

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: o nome do ambiente também. Name é usado no painel do Amazon EC2 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).

Se você usar a CLI do EB para criar um ambiente, use a opção --tags com eb create para adicionar tags.

~/workspace/my-app$ eb create --tags mytag1=value1,mytag2=value2

Com a AWS CLI ou outros clientes baseados em API, use o parâmetro --tags no comando create-environment.

$ 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 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 Beanstalk e, na lista Regions (Regiões), selecione a sua Região da AWS.

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

   nota

   Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.

3. No painel de navegação, selecione Tags.

   A página de gerenciamento de tags mostra a lista de tags que existem atualmente no ambiente.

   

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

5. 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 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 a AWS CLI ou outros clientes baseados em API, use o comando list-tags-for-resource 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 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 comandos da AWS CLI 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