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.
Vous pouvez attribuer vos propres métadonnées aux flux et aux consommateurs de fans améliorés 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 les AWS ressources et d'organiser les données, y compris les données de facturation.
Table des matières
Passez en revue les bases des tags
Les ressources Kinesis Data Streams que vous pouvez baliser incluent les flux de données et les consommateurs fans améliorés. Vous utilisez la console AWS CLI Kinesis Data Streams ou l'API Kinesis Data Streams pour effectuer les tâches suivantes :
-
Création d'une ressource avec des balises
-
Ajouter des balises à une ressource
-
Répertoriez les balises de vos ressources
-
Supprimer les balises d'une ressource
Note
La console Kinesis Data Streams ne permet pas d'appliquer de tags à des clients fans avertis. Pour appliquer des tags aux consommateurs, utilisez l' AWS CLI API Kinesis Data Streams.
Vous pouvez également utiliser des balises pour classer vos ressources par catégorie. Par exemple, vous pouvez classer les ressources 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 qui vous aident à suivre les ressources par propriétaire et par 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
Important
-
Pour ajouter des balises lors de la création d'un flux, vous devez inclure les
kinesis:AddTagsToStreamautorisationskinesis:CreateStreamet pour ce flux. Vous ne pouvez pas utiliser l'kinesis:TagResourceautorisation pour baliser des flux lors de leur création. -
Pour ajouter des balises lors de l'enregistrement du consommateur, vous devez inclure les
kinesis:RegisterStreamConsumerautorisationskinesis:TagResourceet.
Suivez les coûts à l'aide du balisage
Vous pouvez utiliser des balises pour classer et suivre vos AWS coûts. Lorsque vous appliquez des balises à vos ressources Kinesis Data Streams, AWS votre rapport de répartition des coûts inclut l'utilisation et les coûts agrégés par balises. Vous pouvez appliquer des balises représentant des catégories commerciales, telles que les centres de coûts, les noms d'applications ou les propriétaires, afin d'organiser vos coûts entre plusieurs services. 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 .
Comprendre les restrictions relatives aux balises
Les restrictions suivantes s’appliquent aux balises :
Restrictions de base
-
Le nombre maximum de balises pour chaque 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 commencer une clé de balise par,
aws:car ce préfixe est réservé à l'usage de 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, mettre à jour, répertorier et supprimer des balises sur vos flux à l'aide de la console Kinesis Data Streams.
Pour afficher les balises d'un flux
-
Dans le volet de navigation de gauche, choisissez Data streams.
-
Sur la page Flux de données, choisissez le flux que vous souhaitez baliser.
-
Sur la page des détails du flux, choisissez Configuration.
-
Dans la section Tags, visualisez les tags appliqués au flux.
Pour créer un flux de données avec une balise
-
Ouvrez la console Kinesis Data Streams.
-
Dans le volet de navigation de gauche, choisissez Data streams.
-
Choisissez Create data stream (Créer un flux de données).
-
Sur la page Créer un flux de données, entrez le nom de votre flux de données.
-
Pour la capacité du flux de données, choisissez le mode à la demande ou le mode Capacité provisionnée.
Pour plus d'informations sur les modes de capacité, consultezChoisissez le mode de capacité du flux de données.
-
Dans la section Tags, procédez comme suit :
-
Sélectionnez Ajouter une nouvelle balise.
-
Pour Clé, entrez la balise 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 respecte 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).
Pour ajouter ou mettre à jour un tag dans un stream
-
Ouvrez la console Kinesis Data Streams.
-
Dans le volet de navigation de gauche, choisissez Data streams.
-
Sur la page Flux de données, choisissez le flux auquel vous souhaitez ajouter ou mettre à jour des balises.
-
Sur la page des détails du flux, choisissez Configuration.
-
Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).
-
Sous Balises, effectuez l'une des opérations suivantes :
-
Pour ajouter une nouvelle balise, choisissez Ajouter une nouvelle balise, puis entrez les données de clé et de valeur de la balise. Répétez cette étape autant de fois que nécessaire.
Le nombre maximum de balises que vous pouvez ajouter pour chaque flux est de 50.
-
Pour mettre à jour une balise existante, entrez une nouvelle valeur de balise dans le champ Valeur de la clé de cette balise.
Si une erreur s'affiche, cela signifie que la clé ou la valeur de balise que vous avez spécifiée ne respecte pas les restrictions de balise. Pour de plus amples informations, veuillez consulter Comprendre les restrictions relatives aux balises.
-
-
Sélectionnez Save Changes (Enregistrer les modifications).
Pour supprimer une balise d'un flux
-
Ouvrez la console Kinesis Data Streams.
-
Dans le volet de navigation de gauche, choisissez Data streams.
-
Sur la page Flux de données, choisissez le flux dont vous souhaitez supprimer les balises.
-
Sur la page des détails du flux, choisissez Configuration.
-
Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).
-
Recherchez la paire clé et valeur de balise que vous souhaitez supprimer. Choisissez ensuite Supprimer.
-
Sélectionnez Enregistrer les modifications.
Étiquetez les flux à l'aide du AWS CLI
Vous pouvez ajouter, répertorier et supprimer des balises sur vos flux à l'aide du AWS CLI. Pour obtenir 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 APIs
Vous pouvez ajouter, répertorier et supprimer des balises sur vos flux à l'aide des Kinesis Data APIs 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é.
Taguez les consommateurs à l'aide du AWS CLI
Vous pouvez ajouter, répertorier et supprimer des tags sur vos clients à l'aide du AWS CLI. Pour obtenir des exemples, consultez la documentation suivante :
- register-stream-consumer
-
Enregistre un consommateur pour un flux de données Kinesis avec des balises.
- tag-resource
-
Ajoute ou met à jour les balises pour la ressource Kinesis spécifiée.
- list-tags-for-resource
-
Répertorie les balises de la ressource Kinesis spécifiée.
- untag-resource
-
Supprime les balises de la ressource Kinesis spécifiée.
Identifiez les consommateurs à l'aide des Kinesis Data Streams APIs
Vous pouvez ajouter, répertorier et supprimer des tags sur vos clients à l'aide des Kinesis Data APIs Streams. Pour obtenir des exemples, consultez la documentation suivante :
- RegisterStreamConsumer
-
Enregistre un consommateur pour un flux de données Kinesis avec des balises.
- TagResource
-
Ajoute ou met à jour les balises pour la ressource Kinesis spécifiée.
- ListTagsForResource
-
Répertorie les balises de la ressource Kinesis spécifiée.
- UntagResource
-
Supprime les balises de la ressource Kinesis spécifiée.
