Etiquetar AWS Direct Connect recursos

Una etiqueta es una etiqueta que el propietario de un recurso asigna a sus AWS Direct Connect recursos. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Las etiquetas permiten al propietario del recurso clasificar AWS Direct Connect los recursos de diferentes maneras, por ejemplo, por propósito 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, tiene dos AWS Direct Connect conexiones en una región, cada una en ubicaciones diferentes. 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 AWS Direct Connect y se interpretan estrictamente como una cadena 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 AWS Direct Connect recursos mediante la AWS Direct Connect consola, la AWS Direct Connect API, la AWS CLI AWS Tools for Windows PowerShell, la o una AWS SDK. Cuando utilice estas herramientas para administrar etiquetas, debe especificar el nombre del recurso de Amazon (ARN) para el recurso. Para obtener más información al respectoARNs, consulte Amazon Resource Names (ARNs) en 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 aws: prefijo está reservado para su AWS uso. 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 costes solo se admiten para conexiones, interconexiones y. LAGs Para obtener información sobre cómo usar las etiquetas en la administración de costos, consulte Uso de etiquetas de asignación de costos en la Guía del AWS Billing and Cost Management usuario.

Trabajar con etiquetas mediante CLI o 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