Balisage de vos flux de données 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. 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 identifications

Vous utilisez la console Kinesis Data Streams, AWS CLI ou l'API Kinesis Data Streams pour effectuer les tâches suivantes :

• 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

Suivi des coûts à l'aide du balisage

Vous pouvez utiliser les balises pour classer et suivre vos coûts AWS. Lorsque vous appliquez des balises à vos ressources AWS, notamment aux flux, votre rapport de ventilation des coûts AWS comprend l'utilisation et les coûts regroupé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, 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 identifications

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 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 de 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

1. 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.

2. Dans la page Liste de flux, sélectionnez un flux.

3. Dans la page Détails du flux, cliquez sur l'onglet Balises.

Pour ajouter une balise à un flux

1. 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.

2. Dans la page Liste de flux, sélectionnez un flux.

3. Dans la page Détails du flux, cliquez sur l'onglet Balises.

4. Spécifiez la clé de balise dans le champ Clé. Si nécessaire, spécifiez une valeur de balise dans le champ Valeur, puis choisissez Ajouter balise.

   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 Restrictions liées aux identifications.

5. Pour afficher votre nouvelle balise dans la liste dans l'onglet Balises, cliquez sur l'icône d'actualisation.

Pour supprimer une balise d'un flux

1. 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.

2. Dans la page Liste de flux, sélectionnez un flux.

3. Dans la page Détails du flux, cliquez sur l'onglet Balises, puis sur l'icône Supprimer de la balise.

4. Dans la boîte de dialogue Supprimer balise, cliquez sur Oui, supprimer.

Balisage des flux à l'aide de l'AWS CLI

Vous pouvez ajouter, répertorier et supprimer des balises à l'aide de l'AWS CLI. Pour obtenir des exemples, consultez la documentation suivante :

add-tags-to-stream (ajouter-balises-au-flux)

Ajoute ou met à jour les balises du flux spécifié.

list-tags-for-stream (afficher-balises-du-flux)

Répertorie les balises du flux spécifié.

remove-tags-from-stream (supprimer-balises-du-flux)

Supprime les balises du flux spécifié.

Balisage des flux à l'aide de l'API Kinesis Data Streams

Vous pouvez ajouter, répertorier et supprimer des balises à l'aide de l'API Kinesis Data Streams. Pour obtenir des exemples, consultez la documentation suivante :

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é.