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.
# Etiquetar recursos de AWS Direct Connect
Una etiqueta es un elemento que el propietario de un recurso asigna a sus recursos de Direct Connect. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Las etiquetas permiten al propietario del recurso clasificar los recursos de Direct Connect de diversas maneras, por ejemplo, según su finalidad o entorno. Esto es útil cuando tiene muchos recursos del mismo tipo, ya que puede identificar rápidamente un recurso específico en función de las etiquetas que le haya asignado.
Por ejemplo, si tiene dos conexiones de Direct Connect en una región y cada una está en una ubicación diferente. La conexión `dxcon-11aa22bb` es una conexión que sirve tráfico de producción y que está asociada a la interfaz virtual `dxvif-33cc44dd`. La conexión `dxcon-abcabcab` es una conexión redundante (backup) asociada a la interfaz virtual `dxvif-12312312`. Para ayudar a distinguirlas, puede etiquetar las conexiones e interfaces virtuales tal y como se indica a continuación:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/directconnect/latest/UserGuide/using-tags.html)
Recomendamos que idee un conjunto de claves de etiqueta que cumpla sus necesidades para cada tipo de recurso. Mediante el uso de un conjunto coherente de claves de etiquetas, podrá administrar los recursos más fácilmente. Las etiquetas no tienen ningún significado semántico para Direct Connect, por lo que se interpretan estrictamente como cadenas de caracteres. Además, las etiquetas no se asignan a los recursos automáticamente. Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo. Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso.
Puede etiquetar los siguientes recursos de Direct Connect mediante la consola de Direct Connect, la API de Direct Connect, la AWS CLI, las AWS Tools for Windows PowerShell o un AWS SDK. Cuando se utilizan estas herramientas para administrar etiquetas, es preciso especificar el nombre de recurso de Amazon (ARN) del recurso. Para obtener más información acerca de los ARN, consulte [Nombres de recurso de Amazon (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) en la *Referencia general de Amazon Web Services*.
| Recurso | Admite etiquetas | Admite etiquetas en la creación | Admite etiquetas que controlan el acceso y la asignación de recursos | Admite la asignación de costos |
| --- | --- | --- | --- | --- |
| Connections | Sí | Sí | Sí | Sí |
| Interfaces virtuales | Sí | Sí | Sí | No |
| Grupos de agregación de enlaces (LAG) | Sí | Sí | Sí | Sí |
| Interconexiones | Sí | Sí | Sí | Sí |
| Puertas de enlace de Direct Connect | Sí | Sí | Sí | No |
## Restricciones de las etiquetas
Las siguientes reglas y restricciones se aplican a las etiquetas:
+ Número máximo de etiquetas por recurso: 50
+ Longitud máxima de la clave: 128 caracteres Unicode
+ Longitud máxima del valor: 265 caracteres Unicode
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ El prefijo `aws:` se reserva para uso de AWS. No puede editar ni eliminar la clave o el valor de una etiqueta cuando la etiqueta tiene una clave de etiqueta con el prefijo `aws:`. Las etiquetas con una clave de etiqueta con el prefijo `aws:` no cuentan para el límite de etiquetas por recurso.
+ Los caracteres permitidos son letras, espacios y números representables en UTF-8, además de los siguientes caracteres especiales: \$1 - = . \$1 : / @
+ Solo el propietario del recurso puede añadir o eliminar etiquetas. Por ejemplo, si hay una conexión alojada, el socio no podrá añadir, eliminar ni ver las etiquetas.
+ Las etiquetas de asignación de costos solo se admiten para conexiones, interconexiones y LAG. Para obtener información sobre cómo utilizar etiquetas con la administración de costos, consulte [Uso de etiquetas de asignación de costos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *Guía del usuario de Administración de facturación y costos de AWS*.
## Uso de etiquetas mediante la CLI o la API
Utilice lo siguiente para añadir, actualizar, listar y eliminar las etiquetas de los recursos.
| Tarea | API | CLI |
| --- | --- | --- |
| Agregar o sobrescribir una o varias etiquetas. | [TagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) |
| Eliminar una o varias etiquetas. | [UntagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) |
| Describir una o varias etiquetas. | [DescribeTags](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_DescribeTags.html) | [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) |
### Ejemplos
Utilice el comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) para etiquetar la conexión `dxcon-11aa22bb`.
```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"
```
Utilice el comando [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) para describir las etiquetas `dxcon-11aa22bb` de la conexión.
```
aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```
Utilice el comando [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) para eliminar una etiqueta de la conexión `dxcon-11aa22bb`.
```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose
```