Balisage de vos ressources AWS IoT 1-Click - AWS IoT 1-Click

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Balisage de vos ressources AWS IoT 1-Click

Pour vous aider à gérer vos ressources AWS IoT 1-Click, vous pouvez affecter vos propres métadonnées à n'importe quelle ressource ARN à l'aide de balises. Ce chapitre décrit les balises et vous montre comment les créer.

Principes de base des balises

Les balises vous permettent de classer vos ressources AWS IoT 1-Click de différentes manières, par exemple, par objectif, par propriétaire ou par environnement. Cette approche est utile lorsque vous avez de nombreuses ressources de même type : elle vous permet d'identifier rapidement une ressource spécifique en fonction des balises que vous lui avez attribuées. Chaque balise est constituée d'une clé et d'une valeur facultative que vous définissez. Par exemple, vous pouvez définir un ensemble de balises pour plusieurs boutons appartenant à un responsable ou à un compte particulier. Vous pouvez rechercher et filtrer les ressources en fonction des balises que vous ajoutez. Nous vous recommandons de concevoir un ensemble de clés de balise 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. Pour plus d'informations, consultez Stratégies de balisage AWS.

Vous pouvez également utiliser les balises pour classer les coûts par catégorie et en effectuer le suivi. Lorsque vous appliquez des balises à des ressources, AWS génère un rapport de répartition des coûts sous forme de fichier CSV faisant ressortir l'utilisation et les coûts regroupés par les balises. Vous pouvez appliquer des balises associées à des catégories métier (telles que les centres de coûts, les noms d'applications ou les propriétaires) pour organiser les coûts relatifs à divers services. Pour en savoir plus sur l'utilisation des balises pour la répartition des coûts, consultez Utilisation des balises de répartition des coûts dans le Manuel de l'utilisateur AWS Billing and Cost Management.

À des fins de facilité d'utilisation, utilisez Tag Editor dans AWS Management Console, qui offre une façon centralisée et unifiée de créer et gérer vos balises. Pour plus d'informations, consultez Utilisation de Tag Editor dans le Mise en route avec AWS Management Console.

Vous pouvez aussi gérer les balises à l'aide de l'interface de ligne de commande AWS et des API AWS IoT 1-Click. Vous pouvez associer des balises à des projets et des appareils AWS IoT 1-Click lorsque vous les créez à l'aide de l'outilbalises.dans les commandes suivantes :

Vous pouvez ajouter, modifier ou supprimer des balises pour les ressources existantes en utilisant les commandes suivantes :

AWS IoT 1-ClickAPI Projets(en utilisant les ARN de projet) AWS IoT 1-ClickAPI Appareils(en utilisant les ARN de périphériques)
TagResource Tag

Voir TagResource (POST), TagListTagsForResource (GET) et UntagResource (DELETE).

ListTagsForResource
UntagResource

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, toutes les balises associées à celle-ci sont également supprimées.

Restrictions liées aux balises

Les restrictions de base suivantes s'appliquent aux balises :

  • Nombre maximal de balises par ressource – 50

  • Longueur de clé maximale : 127 caractères Unicode en UTF-8

  • Longueur de valeur maximale : 255 caractères Unicode en UTF-8

  • Les clés et valeurs de balise sont sensibles à la casse.

  • N'utilisez pas le préfixe aws: dans les noms ou valeurs de vos balises, car celui-ci est réservé à AWS. Vous ne pouvez pas modifier ou supprimer des noms ou valeurs de balise ayant ce préfixe. Les balises avec ce préfixe ne sont pas comptabilisées comme vos balises pour la limite de ressources.

  • Si votre schéma de balisage est utilisé pour plusieurs services et ressources, n'oubliez pas que d'autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont les lettres, les espaces et les chiffres représentables en UTF-8, ainsi que les caractères spéciaux suivants : + - = . _ : / @