AWS Direct Connect Ressources de balises

Une balise est une étiquette que le propriétaire d'une ressource attribue à ses AWS Direct Connect ressources. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez. Les balises permettent au propriétaire de la ressource de classer vos AWS Direct Connect ressources de différentes manières, par exemple par objectif ou par environnement. Cela s'avère utile quand il existe un grand nombre de ressources du même type : vous pouvez identifier rapidement une ressource spécifique en fonction des balises que vous lui avez attribuées.

Par exemple, vous avez deux AWS Direct Connect connexions dans une région, chacune située à des emplacements différents. La connexion dxcon-11aa22bb traite le trafic de production et est associée à l'interface virtuelle dxvif-33cc44dd. La connexion dxcon-abcabcab est une connexion redondante (sauvegarde) et est associée à l'interface virtuelle dxvif-12312312. Vous pouvez choisir de baliser vos connexions et interfaces virtuelles comme suit, pour les différencier :

ID de ressource	Clé de balise	Valeur de balise
dxcon-11aa22bb	Objectif	Production
	Emplacement	Amsterdam
dxvif-33cc44dd	Objectif	Production
dxcon-abcabcab	Objectif	Sauvegarde
	Emplacement	Francfort
dxvif-12312312	Objectif	Sauvegarde

Nous vous recommandons de concevoir un ensemble de clés d’étiquette répondant à vos besoins pour chaque type de ressource. L’utilisation d’un ensemble de clés de balise cohérent facilite la gestion de vos ressources. Les balises n'ont aucune signification sémantique AWS Direct Connect et sont interprétées strictement comme des chaînes de caractères. De plus, les étiquettes ne sont pas automatiquement affectées à vos ressources. Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. Vous pouvez définir la valeur d’une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d’une balise sur null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur. Si vous supprimez une ressource, ses balises sont également supprimées.

Vous pouvez baliser les AWS Direct Connect ressources suivantes à l'aide de la AWS Direct Connect console AWS Direct Connect API, du AWS CLI, du AWS Tools for Windows PowerShell, ou d'un AWS SDK. Lorsque vous utilisez ces outils pour gérer les balises, vous devez spécifier le nom de la ressource Amazon (ARN) pour la ressource. Pour plus d'informations surARNs, consultez Amazon Resource Names (ARNs) dans le Référence générale d'Amazon Web Services.

Ressource	Prend en charge les étiquettes	Prend en charge les balises lors de la création	Prend en charge les balises contrôlant l'accès et l'allocation des ressources	Prend en charge la répartition des coûts
Connexions	Oui	Oui	Oui	Oui
Interfaces virtuelles	Oui	Oui	Oui	Non
Groupes d'agrégation de liens (LAG)	Oui	Oui	Oui	Oui
Interconnexions	Oui	Oui	Oui	Oui
Passerelles Direct Connect	Non	Non	Non	Non

Restrictions liées aux étiquettes

Les règles et restrictions suivantes s'appliquent aux balises :

• Nombre maximal de balises par ressource : 50

• Longueur de clé maximale : 128 caractères Unicode

• Longueur de valeur maximale : 265 caractères Unicode

• Les clés et valeurs d’étiquette sont sensibles à la casse.

• Le aws: préfixe est réservé à l' AWS usage. Vous ne pouvez pas modifier ou supprimer la clé ou la valeur d'une balise lorsque la balise possède une clé de balise avec le préfixe aws:. Les balises avec le préfixe aws: ne sont pas comptabilisées comme vos balises pour la limite de ressources.

• Les caractères autorisés sont les lettres, les espaces et les chiffres représentables en UTF -8, ainsi que les caractères spéciaux suivants : + - =. _ :/@

• Seul le propriétaire de la ressource peut ajouter ou supprimer des balises. Par exemple, dans le cas d'une connexion hébergée, le partenaire ne sera pas en mesure d'ajouter, de supprimer ou d'afficher les balises.

• Les balises de répartition des coûts ne sont prises en charge que pour les connexions, les interconnexions etLAGs. Pour plus d'informations sur l'utilisation des balises dans le cadre de la gestion des coûts, consultez la section Utilisation des balises de répartition des coûts dans le guide de AWS Billing and Cost Management l'utilisateur.

Utilisation des balises à l'aide du CLI ou API

Utilisez les commandes suivantes pour ajouter, mettre à jour, répertorier et supprimer les étiquettes pour vos ressources.

Tâche	API	CLI
Ajouter ou remplacer une ou plusieurs étiquettes.	TagResource	tag-resource
Supprimer une ou plusieurs étiquettes.	UntagResource	untag-resource
Décrire une ou plusieurs balises.	DescribeTags	describe-tags

Exemples

Utilisez la commande tag-resource pour baliser la connexion dxcon-11aa22bb.

aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"

Utilisez la commande describe-tags pour décrire les balises de la connexion dxcon-11aa22bb.

aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb

Utilisez la commande untag-resource pour supprimer une balise d'une connexion dxcon-11aa22bb.

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose