eb tags - AWS Elastic Beanstalk
DescriçãoSintaxeOpçõesSaídaExemplos

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

Descrição

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.

Sintaxe

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 argumento environment-name, 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

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.

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

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

-r region

ou

--region region

A Região da AWS no qual 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 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 específico do recurso de interesse. Esses tópicos mostram como o ARN do recurso é construído e explicam como obter uma lista dos ARNs desse recurso que existem para o aplicativo ou a conta.

Saída

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

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.