Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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 |
---|---|
o bien
|
Enumere todas las etiquetas aplicadas actualmente al recurso. |
o bien
|
Aplique nuevas etiquetas al recurso. Especifique las etiquetas como una lista de pares Valores válidos: consulte Etiquetado de recursos. |
o bien
|
Actualice los valores de etiquetas de recursos existentes. Especifique las etiquetas como una lista de pares Valores válidos: consulte Etiquetado de recursos. |
o bien
|
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. |
o bien
|
La Región de AWS en el que existe el recurso. Default: la región configurada predeterminada. Para obtener la lista de valores que puede especificar para esta opción, consulte Puntos de enlace y cuotas de AWS Elastic Beanstalk en la Referencia general de AWS. |
|
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. |
Output
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 agrega 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 agrega 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.