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**
## Description (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](applications-tagging-resources.md).
## Sintaxis
**eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list**
**eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --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 *environment-name* argumento, 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](applications-tagging-resources.md). |
| `-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](applications-tagging-resources.md). |
| `-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](applications-tagging-resources.md). |
| `-r` *region* o `--region` *region* | El lugar Región de AWS en el que se encuentra el recurso. Default: la región configurada predeterminada. Para obtener la lista de valores que puede especificar para esta opción, consulte [Puntos de conexión y cuotas de AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) en la *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](applications-tagging-resources.md) específicos del recurso en el que está interesado. En estos temas se muestra cómo se construye el ARN del recurso y se explica cómo obtener una lista de los recursos ARNs que existen 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.
```