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 \| --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 {{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.
```