Balisage d'un cluster Amazon MSK - Amazon Managed Streaming for Apache Kafka

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 d'un cluster Amazon MSK

Vous pouvez affecter vos propres métadonnées sous la forme de balises à une ressource Amazon MSK, telle qu'un cluster MSK. Une balise est une paire clé-valeur que vous définissez pour la ressource. Les balises constituent une méthode simple et puissante de gestion des ressources AWS et d'organisation des données, y compris les données de facturation.

Principes de base des étiquettes

Vous pouvez utiliser l'API Amazon MSK pour effectuer les tâches suivantes :

  • Ajouter des balises à une ressource Amazon MSK.

  • Répertorier les balises pour une ressource Amazon MSK.

  • Supprimer les balises d'une ressource Amazon MSK.

Vous pouvez également utiliser des balises pour classer vos ressources Amazon MSK par catégorie. Par exemple, vous pouvez classer les clusters Amazon MSK par objectif, propriétaire ou environnement. Dans la mesure où vous avez défini la clé et la valeur de chaque balise, vous pouvez créer un ensemble personnalisé de catégories répondant à vos besoins spécifiques. Par exemple, vous pouvez définir un ensemble de balises vous permettant de suivre les clusters par propriétaire et application associée.

Voici plusieurs exemples de balises :

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Environment: Production

Suivi des coûts à l'aide d'étiquettes

Vous pouvez utiliser les balises pour classer et suivre vos coûts AWS. Lorsque vous appliquez des balises à vos ressources AWS, notamment aux clusters Amazon MSK, votre rapport de ventilation des coûts AWS comprend l'utilisation et les coûts regroupés par balise. Vous pouvez organiser vos coûts entre plusieurs services en appliquant des balises qui représentent des catégories métier (telles que les centres de coûts, les noms d'applications ou les propriétaires). Pour plus d'informations, consultez Utilisation des identifications de répartition des coûts pour les rapports de facturation personnalisés dans le Guide de l'utilisateur AWS Billing.

Restrictions liées aux étiquettes

Les restrictions suivantes s'appliquent aux balises dans Amazon MSK.

Restrictions de base
  • Le nombre maximum d'identifications par ressource est de 50.

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

  • Vous ne pouvez pas changer ou modifier les balises d'une ressource supprimée.

Restrictions relatives aux clés de balise
  • Chaque clé de balise doit être unique. Si vous ajoutez une balise avec une clé qui est déjà en cours d'utilisation, la nouvelle balise remplacera la paire clé-valeur existante.

  • Vous ne pouvez pas démarrer une clé de balise avec, aws: car ce préfixe est réservé à une utilisation par AWS. AWS crée des balises qui commencent par ce préfixe en votre nom, mais vous ne pouvez pas les modifier ou les supprimer.

  • Les clés de balise doivent comporter entre 1 et 128 caractères Unicode.

  • Les clés de balise doivent comporter les caractères suivants : lettres Unicode, chiffres, espaces et les caractères spéciaux suivants :_ . / = + - @.

Restrictions relatives à la valeur de balise
  • Les valeurs de balise doivent comporter entre 0 et 255 caractères Unicode.

  • Les valeurs de balise peuvent être vides. Si tel n'est pas le cas, elles doivent être composées des caractères suivants : lettres Unicode, chiffres, espaces et les caractères spéciaux suivants :_ . / = + - @.

Balisage des ressources à l'aide de l'API Amazon MSK

Vous pouvez utiliser les opérations suivantes pour marquer ou annuler les balises d'une ressource Amazon MSK ou pour répertorier l'ensemble actuel de balises pour une ressource :