eb tags - AWS Elastic Beanstalk

eb tags

Descripción

Agregar, eliminar, actualizar y enumerar etiquetas de un recurso de Elastic Beanstalk.

Para obtener más información sobre el etiquetado de recursos en Elastic Beanstalk, consulte Etiquetar recursos de la aplicación Elastic Beanstalk.

Sintaxis

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

Puede combinar las opciones de subcomando --add, --update y --delete en un único comando. Se necesita como mínimo uno. No se puede combinar ninguna de estas tres opciones de subcomandos con --list.

Si no hay argumentos adicionales, todos estos comandos enumeran o modifican las etiquetas del entorno predeterminado en la aplicación del directorio actual. Con un argumento environment-name, los comandos enumeran o modifican las etiquetas de ese entorno. Con la opción --resource, los comandos enumeran o modifican las etiquetas de cualquier recurso de Elastic Beanstalk: una aplicación, un entorno, una versión de la aplicación, una configuración guardada o una versión de la plataforma personalizada. Especifique el recurso por su nombre de recurso de Amazon (ARN).

Opciones

Ninguna de estas opciones es obligatoria. Si ejecuta eb create sin especificar ninguna opción, le pedirán que especifique o seleccione un valor para cada ajuste.

Nombre

Descripción

-l

o bien

--list

Enumere todas las etiquetas aplicadas actualmente al recurso.

-a key1=value1[,key2=value2 ...]

o bien

--add key1=value1[,key2=value2 ...]

Aplique nuevas etiquetas al recurso. Especifique las etiquetas como una lista de pares key=value separados por comas. No puede especificar las claves de etiquetas existentes.

Valores válidos: consulte Etiquetado de recursos.

-u key1=value1[,key2=value2 ...]

o bien

--update key1=value1[,key2=value2 ...]

Actualice los valores de etiquetas de recursos existentes. Especifique las etiquetas como una lista de pares key=value separados por comas. Debe especificar las claves de etiquetas existentes.

Valores válidos: consulte Etiquetado de recursos.

-d key1[,key2 ...]

o bien

--delete key1[,key2 ...]

Elimine las etiquetas de recursos existentes. Especifique las etiquetas como una lista de claves separadas por comas. Debe especificar las claves de etiquetas existentes.

Valores válidos: consulte Etiquetado de recursos.

-r region

o bien

--region region

La región de AWS en la que se encuentra su recurso.

Default: la región configurada predeterminada.

Para obtener la lista de valores que puede especificar para esta opción, consulte AWS Elastic Beanstalk Endpoints and Quotas en AWS General Reference (Referencia general de AWS).

--resource ARN

El ARN del recurso para el que el comando modifica o enumera las etiquetas. Si no se especifica, el comando hace referencia al entorno (valor predeterminado o especificado) en la aplicación del directorio actual.

Valores válidos: consulte uno de los subtemas de Etiquetado de recursos específicos del recurso en el que está interesado. Estos temas muestran cómo se construye el ARN del recurso y se explica cómo obtener una lista de los ARN de este recurso para su aplicación o cuenta.

Salida

La opción del subcomando --list muestra una lista de las etiquetas del recurso. La salida muestra tanto las etiquetas que Elastic Beanstalk aplica de forma predeterminada como las etiquetas 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

Las opciones de subcomandos --add, --update y --delete no tienen ninguna salida cuando se ejecutan con éxito. Puede agregar la opción --verbose para ver la salida detallada de la actividad del comando.

$ eb tags --verbose --update "mytag=tag value" Updated Tags: Key Value mytag tag value

Ejemplos

El siguiente comando añade una etiqueta correctamente con la clave tag1 y el valor value1 al entorno predeterminado de la aplicación y, al mismo tiempo, elimina la etiqueta tag2.

$ eb tags --add tag1=value1 --delete tag2

El siguiente comando añade correctamente una etiqueta a una configuración guardada dentro de una aplicación.

$ eb tags --add tag1=value1 \ --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"

El siguiente comando produce un error porque intenta actualizar una etiqueta no existente.

$ eb tags --update tag3=newval ERROR: Tags with the following keys can't be updated because they don't exist: tag3

El siguiente comando produce un error porque intenta actualizar y eliminar la misma clave.

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