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.
Ajoutez des balises à vos flux dans Amazon Kinesis Data Streams
Vous pouvez attribuer vos propres métadonnées aux flux que vous créez dans Amazon Kinesis Data Streams sous forme de balises. Une balise est une paire clé-valeur que vous définissez pour un flux. L'utilisation de balises est un moyen simple mais puissant de gérer AWS ressources et données d'organisation, y compris les données de facturation.
Table des matières
Passez en revue les bases des tags
Vous utilisez la console Kinesis Data Streams, AWS CLI, ou Kinesis Data API Streams pour effectuer les tâches suivantes :
-
Création d'un flux avec des balises
-
Ajouter des balises à un flux
-
Afficher les balises de vos flux
-
Supprimer les balises d'un flux
Les balises vous permettent de classer vos flux. Par exemple, vous pouvez classer les flux 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 flux par propriétaire et application associée. Voici quelques exemples de balises :
-
Projet : nom du projet
-
Propriétaire : nom
-
Objectif : test de la charge
-
Application : nom de l'application
-
Environnement : production
Suivez les coûts à l'aide du balisage
Vous pouvez utiliser des balises pour classer et suivre votre AWS coûts. Lorsque vous appliquez des balises à votre AWS ressources, y compris les flux, votre AWS le rapport de répartition des coûts inclut l'utilisation et les coûts agrégés par 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 plus d'informations, voir Utiliser les balises de répartition des coûts pour les rapports de facturation personnalisés dans le AWS Billing Guide de l'utilisateur
Comprendre les restrictions relatives aux balises
Les restrictions suivantes s'appliquent aux balises :
Restrictions de base
-
Le nombre maximum de balises par ressource (flux) est de 50.
-
Les clés et valeurs d’étiquette sont sensibles à la casse.
-
Vous ne pouvez pas changer ou modifier les balises d'un flux supprimé.
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 commencer une clé de balise par ce préfixe,
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 ni les modifier ni 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 :
_ . / = + - @.
Étiquetez les flux à l'aide de la console Kinesis Data Streams
Vous pouvez ajouter, répertorier et supprimer des balises à l'aide de la console Kinesis Data Streams.
Pour afficher les balises d'un flux
-
Ouvrez la console Kinesis Data Streams. Dans la barre de navigation, développez le sélecteur de région et sélectionnez une région.
-
Dans la page Liste de flux, sélectionnez un flux.
-
Sur la page Détails du stream, choisissez l'onglet Tags.
Pour créer un flux de données avec une balise
-
Ouvrez la console Kinesis Data Streams. Dans la barre de navigation, développez le sélecteur de région et sélectionnez une région.
-
Choisissez Créer un flux.
-
Sur la page Créer un flux de données, entrez un nom pour votre flux de données, puis choisissez le mode à la demande ou le mode de capacité provisionnée. Le mode à la demande est sélectionné par défaut. Pour de plus amples informations, veuillez consulter Choisissez le mode de capacité du flux de données.
-
Dans la section Balises, choisissez Ajouter une balise. Spécifiez la balise dans le champ Clé et spécifiez éventuellement une valeur dans le champ Valeur.
Si une erreur s'affiche, cela signifie que la clé ou la valeur de balise que vous avez spécifiée ne respectent pas les restrictions de balise. Pour de plus amples informations, veuillez consulter Comprendre les restrictions relatives aux balises.
-
Choisissez Create data stream (Créer un flux de données).
-
Sur la page Flux de données, le statut de votre flux s'affiche comme étant en cours de création pendant la création du flux. Lorsque le flux est prêt à être utilisé, le statut passe à Actif.
-
Choisissez le nom de votre flux. La page Détails du flux affiche un récapitulatif de la configuration de flux, ainsi que des informations de surveillance.
Pour ajouter une balise à un flux
-
Ouvrez la console Kinesis Data Streams. Dans la barre de navigation, développez le sélecteur de région et sélectionnez une région.
-
Dans la page Liste de flux, sélectionnez un flux.
-
Sur la page Détails du stream, choisissez l'onglet Tags.
-
Spécifiez la clé de balise dans le champ Clé, spécifiez éventuellement une valeur de balise dans le champ Valeur, puis choisissez Ajouter une étiquette.
Si le bouton Ajouter balise n'est pas activé, la clé ou la valeur de la balise que vous avez spécifiée ne répond pas aux restrictions de balise. Pour de plus amples informations, veuillez consulter Comprendre les restrictions relatives aux balises.
-
Pour afficher votre nouveau tag dans la liste de l'onglet Tags, cliquez sur l'icône d'actualisation.
Pour supprimer une balise d'un flux
-
Ouvrez la console Kinesis Data Streams. Dans la barre de navigation, développez le sélecteur de région et sélectionnez une région.
-
Dans la page Liste de flux, sélectionnez un flux.
-
Sur la page Détails du stream, cliquez sur l'onglet Tags, puis sur l'icône Supprimer pour le tag.
-
Dans la boîte de dialogue Supprimer le tag, choisissez Oui, Supprimer.
Étiquetez les flux à l'aide du AWS CLI
Vous pouvez ajouter, répertorier et supprimer des balises à l'aide du AWS CLI. Pour des exemples, consultez la documentation suivante.
- créer un flux
-
Crée un flux avec des balises.
- add-tags-to-stream
-
Ajoute ou met à jour les balises du flux spécifié.
- list-tags-for-stream
-
Répertorie les balises du flux spécifié.
- remove-tags-from-stream
-
Supprime les balises du flux spécifié.
Étiquetez les flux à l'aide des Kinesis Data Streams API
Vous pouvez ajouter, répertorier et supprimer des balises à l'aide des Kinesis Data API Streams. Pour obtenir des exemples, consultez la documentation suivante :
- CreateStream
-
Crée un flux avec des balises.
- AddTagsToStream
-
Ajoute ou met à jour les balises du flux spécifié.
- ListTagsForStream
-
Répertorie les balises du flux spécifié.
- RemoveTagsFromStream
-
Supprime les balises du flux spécifié.
