Etiquetar recursos de AWS Direct Connect

Una etiqueta es un elemento que el propietario de un recurso asigna a sus recursos de AWS 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 AWS 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 AWS 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:

ID de recurso	Clave de etiqueta	Valor de etiqueta
dxcon-11aa22bb	Finalidad	Producción
	Ubicación	Ámsterdam
dxvif-33cc44dd	Finalidad	Producción
dxcon-abcabcab	Finalidad	Copia de seguridad
	Ubicación	Fráncfort
dxvif-12312312	Finalidad	Copia de seguridad

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 de más fácilmente. Las etiquetas no tienen ningún significado semántico para AWS 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 AWS Direct Connect mediante la consola de AWS Direct Connect, la API de AWS 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) 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
Conexiones	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í
Gateways de Direct Connect	No	No	No	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: + - = . _ : / @

• 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 en la Guía del usuario de AWS Billing and Cost Management.

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	tag-resource
Eliminar una o varias etiquetas.	UntagResource	untag-resource
Describir una o varias etiquetas.	DescribeTags	describe-tags

Ejemplos

Utilice el comando tag-resource 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 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 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