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.
# Utilisation de balises et d'étiquettes pour les ressources Amazon Keyspaces
*Vous pouvez étiqueter les ressources Amazon Keyspaces (pour Apache Cassandra) à l'aide de balises.* Les balises vous permettent de classer vos ressources de différentes manières, par exemple en fonction de leur objectif, de leur propriétaire, de leur environnement ou d'autres critères. Les balises vous permettent d'effectuer les actions suivantes :
+ Identifier rapidement une ressource en fonction des balises que vous lui avez attribuées.
+ Consultez AWS les factures ventilées par tags.
+ Contrôlez l'accès aux ressources Amazon Keyspaces à l'aide de balises. Pour des exemples de politique IAM utilisant des balises, consultez[Autorisation basée sur les tags Amazon Keyspaces](security_iam_service-with-iam.md#security_iam_service-with-iam-tags).
Le balisage est pris en charge par AWS des services tels qu'Amazon Elastic Compute Cloud (Amazon EC2), Amazon Simple Storage Service (Amazon S3), Amazon Keyspaces, etc. Un balisage efficace peut fournir un aperçu sur les coûts en vous permettant de créer des rapports sur les services associés à une balise spécifique.
Pour commencer le balisage, procédez comme suit :
1. Comprendre [Restrictions relatives à l'utilisation de balises pour étiqueter les ressources dans Amazon Keyspaces](TaggingRestrictions.md).
1. Créer des balises en utilisant [Étiquetez les espaces clés, les tables et les flux dans Amazon Keyspaces](Tagging.Operations.md).
1. [Créez des rapports de répartition des coûts à l'aide de balises pour Amazon Keyspaces](CostAllocationReports.md)À utiliser pour suivre vos AWS coûts par tag actif.
En dernier lieu, il est conseillé de suivre les politique de balisage optimales. Pour plus d'informations, consultez [Politiques d'étiquetage AWS](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf).
# Restrictions relatives à l'utilisation de balises pour étiqueter les ressources dans Amazon Keyspaces
Chaque étiquette est constituée d'une clé et d'une valeur, que vous définissez. Les restrictions suivantes s'appliquent :
+ Chaque espace de touches, table ou flux Amazon Keyspaces ne peut comporter qu'une seule balise avec la même clé. Si vous tentez d'ajouter une balise existante (même clé), la valeur de la balise existante est mise à jour avec la nouvelle valeur.
+ Les balises appliquées à un espace de touches ne s'appliquent pas automatiquement aux tables de cet espace de touches. Pour appliquer la même balise à un keyspace et à toutes ses tables, chaque ressource doit être étiquetée individuellement.
+ Les balises appliquées à une table ne s'appliquent pas automatiquement au flux de cette table. Pour appliquer les mêmes balises à une table et au flux lors de la création de la table, vous pouvez utiliser l'`PropagateTagsOnEnable`indicateur lors de la création de la table. À l'aide de cet indicateur, Amazon Keyspaces applique les balises de la table au flux lors de la création du flux. Lorsque le flux est actif, les modifications apportées aux balises du tableau ne s'appliquent pas au flux.
+ Lorsque vous créez un espace de touches ou un tableau multirégional, toutes les balises que vous définissez au cours du processus de création sont automatiquement appliquées à tous les espaces clés et tables de toutes les régions. Lorsque vous modifiez des balises existantes à l'aide de `ALTER KEYSPACE` ou`ALTER TABLE`, la mise à jour ne s'applique qu'au keyspace ou au tableau de la région dans laquelle vous effectuez la modification.
+ Une valeur agit comme un descripteur au sein d'une catégorie d'étiquette (clé). Dans Amazon Keyspaces, la valeur ne peut pas être vide ou nulle.
+ Les clés et valeurs de balise sont sensibles à la casse.
+ La longueur de clé maximale est de 128 caractères Unicode.
+ La longueur de valeur maximale est de 256 caractères Unicode.
+ Les caractères autorisés sont les lettres, les espaces blancs et les chiffres, ainsi que les caractères spéciaux suivants : `+ - = . _ : /`
+ Le nombre maximum d'identifications par ressource est de 50.
+ AWS-les noms et valeurs des balises assignés reçoivent automatiquement le `aws:` préfixe, que vous ne pouvez pas attribuer. AWS-les noms de balises attribués ne sont pas pris en compte dans la limite de 50 balises. Les noms des balises attribuées par l'utilisateur ont le préfixe `user:` dans le rapport de répartition des coûts.
+ Vous ne pouvez pas antidater l'application d'une balise.
# Étiquetez les espaces clés, les tables et les flux dans Amazon Keyspaces
Vous pouvez ajouter, répertorier, modifier ou supprimer des balises pour les espaces clés, les tables et les flux à l'aide de la console Amazon Keyspaces, AWS CLI du langage CQL (Cassandra Query Language). Vous pouvez ensuite activer ces balises définies par l'utilisateur afin qu'elles apparaissent sur la AWS Billing and Cost Management console pour le suivi de la répartition des coûts. Pour de plus amples informations, veuillez consulter [Créez des rapports de répartition des coûts à l'aide de balises pour Amazon Keyspaces](CostAllocationReports.md).
Pour les modifications groupées, vous pouvez également utiliser l'éditeur de balises sur la console. Pour plus d'informations, veuillez consulter [Utilisation de Tag Editor](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) dans le *Guide de l'utilisateur Groupes de ressources AWS *.
Pour plus d'informations sur la structure des balises, consultez [Restrictions relatives à l'utilisation de balises pour étiqueter les ressources dans Amazon Keyspaces](TaggingRestrictions.md).
**Topics**
+ [
# Ajouter des tags lors de la création d'un nouvel espace de touches
](Tagging.Operations.new.keyspace.md)
+ [
# Ajouter des tags à un keyspace
](Tagging.Operations.existing.keyspace.md)
+ [
# Supprimer des tags d'un keyspace
](Tagging.Operations.existing.keyspace.drop.md)
+ [
# Afficher les tags d'un keyspace
](Tagging.Operations.view.keyspace.md)
+ [
# Ajouter des balises lors de la création d'un nouveau tableau
](Tagging.Operations.new.table.md)
+ [
# Ajouter des balises à un tableau
](Tagging.Operations.existing.table.md)
+ [
# Supprimer des balises d'un tableau
](Tagging.Operations.existing.table.drop.md)
+ [
# Afficher les balises d'un tableau
](Tagging.Operations.view.table.md)
+ [
# Ajouter des balises à un nouveau flux lors de la création d'une table
](Tagging.Operations.new.table.stream.md)
+ [
# Ajouter des balises à un nouveau flux pour une table existante
](Tagging.Operations.new.stream.md)
+ [
# Ajouter de nouveaux tags à un stream
](Tagging.Operations.existing.stream.md)
+ [
# Supprimer des balises d'un flux
](Tagging.Operations.existing.stream.drop.md)
+ [
# Afficher les tags d'un stream
](Tagging.Operations.view.stream.md)
# Ajouter des tags lors de la création d'un nouvel espace de touches
Vous pouvez utiliser la console Amazon Keyspaces, le CQL ou le AWS CLI pour ajouter des balises lorsque vous créez un nouvel espace de touches.
------
#### [ Console ]
**Définissez une balise lors de la création d'un nouvel espace de touches à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le panneau de navigation, choisissez **Keyspaces**, puis **Créer un keyspace**.
1. Dans la page **Créer un keyspace** indiquez un nom pour le keyspace.
1. Sous **Balises**, choisissez **Ajouter une nouvelle balise** et entrez une clé et une valeur.
1. Choisissez **Create keyspace**.
------
#### [ Cassandra Query Language (CQL) ]
**Définissez une balise lors de la création d'un nouvel espace de touches à l'aide de CQL**
+ L'exemple suivant crée un nouveau keyspace avec des balises.
```
CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Définissez une balise lors de la création d'un nouvel espace de touches à l'aide du AWS CLI**
+ L'instruction suivante crée un nouvel espace de touches avec des balises.
```
aws keyspaces create-keyspace --keyspace-name 'myKeyspace' --tags 'key=key1,value=val1' 'key=key2,value=val2'
```
------
# Ajouter des tags à un keyspace
Les exemples suivants montrent comment ajouter des balises à un keyspace dans Amazon Keyspaces.
------
#### [ Console ]
**Ajouter un tag à un espace de touches existant à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le panneau de navigation, choisissez **Keyspaces**.
1. Choisissez un espace de touche dans la liste. Choisissez ensuite l'onglet **Tags** où vous pouvez voir les tags du keyspace.
1. Choisissez **Gérer les balises** pour ajouter, modifier ou supprimer des balises.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter une balise à un espace de touches existant à l'aide de CQL**
+
```
ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Ajoutez une balise à un espace de touches existant à l'aide du AWS CLI**
+ L'exemple suivant montre comment ajouter de nouvelles balises à un keyspace existant.
```
aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Supprimer des tags d'un keyspace
------
#### [ Console ]
**Supprimer un tag d'un espace de touches existant à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le panneau de navigation, choisissez **Keyspaces**.
1. Choisissez un espace de touche dans la liste. Choisissez ensuite l'onglet **Tags** où vous pouvez voir les tags du keyspace.
1. Choisissez **Gérer les tags** et supprimez les tags dont vous n'avez plus besoin.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Supprimer une balise d'un espace de touches existant à l'aide de CQL**
+
```
ALTER KEYSPACE mykeyspace DROP TAGS {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Supprimer un tag d'un espace de touches existant à l'aide du AWS CLI**
+ L'instruction suivante supprime les balises spécifiées d'un keyspace.
```
aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Afficher les tags d'un keyspace
Les exemples suivants montrent comment lire des balises à l'aide de la console, du CQL ou du AWS CLI.
------
#### [ Console ]
**Afficher les tags d'un keyspace à l'aide de la console Amazon Keyspaces**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le panneau de navigation, choisissez **Keyspaces**.
1. Choisissez un espace de touche dans la liste. Choisissez ensuite l'onglet **Tags** où vous pouvez voir les tags du keyspace.
------
#### [ Cassandra Query Language (CQL) ]
**Afficher les balises d'un keyspace à l'aide de CQL**
Pour lire les balises associées à un keyspace, utilisez l'instruction CQL suivante.
```
SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause;
```
La `WHERE` clause est obligatoire et doit utiliser l'un des formats suivants :
+ `keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'`
+ `resource_id = arn`
+ L'instruction suivante indique si un espace de touches comporte des balises.
```
SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_type = 'keyspace';
```
La sortie de la commande ressemble à ce qui suit.
```
resource_id | keyspace_name | resource_name | resource_type | tags
-----------------------------------------------------------------+---------------+---------------+---------------+------
arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/ | mykeyspace | mykeyspace | keyspace | {'key1': 'val1', 'key2': 'val2'}
```
------
#### [ CLI ]
**Affichez les balises d'un keyspace à l'aide du AWS CLI**
+ Cet exemple montre comment répertorier les balises de la ressource spécifiée.
```
aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/'
```
Le résultat de la dernière commande ressemble à ceci.
```
{
"tags": [
{
"key": "key1",
"value": "val1"
},
{
"key": "key2",
"value": "val2"
},
{
"key": "key3",
"value": "val3"
},
{
"key": "key4",
"value": "val4"
}
]
}
```
------
# Ajouter des balises lors de la création d'un nouveau tableau
Vous pouvez utiliser la console Amazon Keyspaces, le CQL ou le AWS CLI pour ajouter des balises aux nouvelles tables lorsque vous les créez.
------
#### [ Console ]
**Ajoutez une balise lors de la création d'une nouvelle table à l'aide de la (console)**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le panneau de navigation, choisissez **Tables**, puis **Create table (Créer une table)**.
1. Sur la page **Créer une table**, dans la section **Détails de la table**, sélectionnez un espace de touche et attribuez un nom à la table.
1. Dans la section **Schéma**, créez le schéma de votre table.
1. Dans la section **Paramètres du tableau**, choisissez **Personnaliser les paramètres**.
1. Passez à la section **Balises du tableau — section *facultative***, puis choisissez **Ajouter une nouvelle balise** pour créer de nouvelles balises.
1. Choisissez **Créer un tableau**.
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter des balises lors de la création d'une nouvelle table à l'aide de CQL**
+ L'exemple suivant crée une table avec des balises.
```
CREATE TABLE mytable(...) WITH TAGS = {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Ajoutez des balises lors de la création d'un nouveau tableau à l'aide du AWS CLI**
+ L'exemple suivant montre comment créer une nouvelle table avec des balises. *La commande crée une table *MyTable* dans un espace de touches MyKeyspace déjà existant.* Notez que la commande a été divisée en différentes lignes pour améliorer la lisibilité.
```
aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable'
--schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]'
--tags 'key=key1,value=val1' 'key=key2,value=val2'
```
------
# Ajouter des balises à un tableau
Vous pouvez ajouter des balises à une table existante dans Amazon Keyspaces à l'aide de la console, du CQL ou du. AWS CLI
------
#### [ Console ]
**Ajouter des tags à un tableau à l'aide de la console Amazon Keyspaces**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez un tableau dans la liste, puis cliquez sur l'onglet **Tags**.
1. Choisissez **Gérer les balises** pour ajouter des balises au tableau.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter des balises à une table à l'aide de CQL**
+ L'instruction suivante indique comment ajouter des balises à une table existante.
```
ALTER TABLE mykeyspace.mytable ADD TAGS {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Ajoutez des balises à un tableau à l'aide du AWS CLI**
+ L'exemple suivant montre comment ajouter de nouvelles balises à une table existante.
```
aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Supprimer des balises d'un tableau
------
#### [ Console ]
**Supprimer des tags d'un tableau à l'aide de la console Amazon Keyspaces**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez un tableau dans la liste, puis cliquez sur l'onglet **Tags**.
1. Choisissez **Gérer les balises** pour supprimer les balises du tableau.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Supprimer des balises d'une table à l'aide de CQL**
+ L'instruction suivante indique comment supprimer des balises d'une table existante.
```
ALTER TABLE mytable DROP TAGS {'key3':'val3', 'key4':'val4'};
```
------
#### [ CLI ]
**Ajoutez des balises à un tableau à l'aide du AWS CLI**
+ L'instruction suivante supprime les balises spécifiées d'un keyspace.
```
aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Afficher les balises d'un tableau
Les exemples suivants montrent comment afficher les balises d'une table dans Amazon Keyspaces à l'aide de la console, du CQL ou du. AWS CLI
------
#### [ Console ]
**Afficher les balises d'un tableau à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez un tableau dans la liste, puis cliquez sur l'onglet **Tags**.
------
#### [ Cassandra Query Language (CQL) ]
**Afficher les balises d'une table à l'aide de CQL**
Pour lire les balises associées à une table, utilisez l'instruction CQL suivante.
```
SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause;
```
La `WHERE` clause est obligatoire et doit utiliser l'un des formats suivants :
+ `keyspace_name = 'mykeyspace' AND resource_name = 'mytable'`
+ `resource_id = arn`
+ La requête suivante renvoie les balises de la table spécifiée.
```
SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_name = 'mytable';
```
La sortie de cette requête se présente comme suit :
```
resource_id | keyspace_name | resource_name | resource_type | tags
----------------------------------------------------------------------------+---------------+---------------+---------------+------
arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable| mykeyspace | mytable | table | {'key1': 'val1', 'key2': 'val2'}
```
------
#### [ CLI ]
**Affichez les balises d'un tableau à l'aide du AWS CLI**
+ Cet exemple montre comment répertorier les balises de la ressource spécifiée.
```
aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable'
```
Le résultat de la dernière commande ressemble à ceci.
```
{
"tags": [
{
"key": "key1",
"value": "val1"
},
{
"key": "key2",
"value": "val2"
},
{
"key": "key3",
"value": "val3"
},
{
"key": "key4",
"value": "val4"
}
]
}
```
------
# Ajouter des balises à un nouveau flux lors de la création d'une table
Vous pouvez ajouter des balises aux flux lorsque vous créez une nouvelle table avec un flux à l'aide de CQL ou AWS CLI pour baliser un flux.
**Note**
Amazon Keyspaces CDC nécessite la présence d'un rôle lié à un service (`AWSServiceRoleForAmazonKeyspacesCDC`) qui publie les données métriques provenant des flux Amazon Keyspaces CDC sur votre compte en votre nom`"cloudwatch:namespace": "AWS/Cassandra"`. CloudWatch Ce rôle est créé automatiquement pour vous. Pour de plus amples informations, veuillez consulter [Utilisation de rôles pour les flux CDC d'Amazon Keyspaces](using-service-linked-roles-CDC-streams.md).
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter des balises à un flux lors de la création d'une nouvelle table à l'aide de CQL**
1. Pour créer une nouvelle table avec un flux et appliquer automatiquement les balises du tableau au flux, vous pouvez utiliser l'`'propagate_tags': 'TABLE'`indicateur. La déclaration suivante en est un exemple.
```
CREATE TABLE mytable (pk int, ck text, PRIMARY KEY(pk))
WITH TAGS={'key1':'val1', 'key2':'val2'}
AND cdc = TRUE
AND CUSTOM_PROPERTIES={
'cdc_specification': {
'view_type': 'NEW_IMAGE',
'propagate_tags': 'TABLE'
}
};
```
1. Pour appliquer de nouvelles balises au flux, vous pouvez utiliser l'exemple suivant.
```
CREATE TABLE mytable (pk int, ck text, PRIMARY KEY(pk))
WITH TAGS={'key1':'val1', 'key2':'val2'}
AND cdc = TRUE
AND CUSTOM_PROPERTIES={
'cdc_specification': {
'view_type': 'NEW_IMAGE',
'tags': { 'key': 'string', 'value': 'string' },
}
};
```
------
#### [ CLI ]
**Ajoutez des balises à un flux lors de la création d'une nouvelle table à l'aide du AWS CLI**
1. Pour créer une table avec un flux et appliquer automatiquement les balises du tableau au flux, vous pouvez utiliser l'`propagateTags=Table`indicateur. Le code suivant en est un exemple.
```
aws keyspaces create-table \
--keyspace-name 'my_keyspace' \
--table-name 'my_table' \
--schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=text}],clusteringKeys=[{name=ck,orderBy=ASC}],partitionKeys=[{name=pk}]' \
--tags key=tag_key,value=tag_value
--cdc-specification propagateTags=TABLE,status=ENABLED,viewType=NEW_IMAGE
```
1. Pour appliquer différentes balises au flux, vous pouvez utiliser l'exemple suivant.
```
aws keyspaces create-table \
--keyspace-name 'my_keyspace' \
--table-name 'my_table' \
--schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=text}],clusteringKeys=[{name=ck,orderBy=ASC}],partitionKeys=[{name=pk}]' \
--tags key=tag_key,value=tag_value
--cdc-specification 'status=ENABLED,viewType=NEW_IMAGE,tags=[{key=tag_key, value=tag_value}]'
```
------
# Ajouter des balises à un nouveau flux pour une table existante
Vous pouvez ajouter des balises lorsque vous créez un nouveau flux pour une table existante. Vous pouvez utiliser l'`PropagateTags`indicateur pour appliquer les balises de table au flux ou spécifier de nouvelles balises pour le flux. Vous pouvez utiliser le CQL ou le AWS CLI pour baliser un nouveau flux.
**Note**
Amazon Keyspaces CDC nécessite la présence d'un rôle lié à un service (`AWSServiceRoleForAmazonKeyspacesCDC`) qui publie les données métriques provenant des flux Amazon Keyspaces CDC sur votre compte en votre nom`"cloudwatch:namespace": "AWS/Cassandra"`. CloudWatch Ce rôle est créé automatiquement pour vous. Pour de plus amples informations, veuillez consulter [Utilisation de rôles pour les flux CDC d'Amazon Keyspaces](using-service-linked-roles-CDC-streams.md).
------
#### [ Console ]
**Ajoutez des balises lors de la création d'un nouveau flux à l'aide de la (console)**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**, puis choisissez la table pour laquelle vous souhaitez ajouter un flux.
1. Choisissez l'onglet **Streams**.
1. Dans la section **Détails du flux**, choisissez **Modifier**.
1. Sélectionnez **Activer les streams**.
1. Sélectionnez le **type d'affichage** et passez à **Tags** pour créer des balises pour le flux.
1. Vous pouvez sélectionner l'une des options suivantes :
+ **Pas de balises** : utilisez cette option si vous ne souhaitez pas créer de balises pour le flux.
+ **Copier les balises de la table** : utilisez cette option si vous souhaitez copier les balises de la table vers le flux. Après avoir copié les tags, vous pouvez les modifier pour le stream. Notez que cette option n'est disponible que si le tableau comporte des balises.
+ **Ajouter de nouveaux tags** — Vous pouvez ajouter jusqu'à 50 tags pour le stream en choisissant **Ajouter un nouveau tag**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter des tags lors de la création d'un nouveau stream**
1. Pour créer un nouveau flux pour une table existante et appliquer les balises de la table au flux, vous pouvez utiliser l'`'propagate_tags': 'TABLE'`indicateur. Les déclarations suivantes en sont un exemple.
```
ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'propagate_tags': 'TABLE' } };
```
1. Pour créer un nouveau flux pour une table existante et spécifier de nouvelles balises, vous pouvez utiliser l'exemple suivant.
```
ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'tags': { 'key': 'string', 'value': 'string' }} };
```
------
#### [ CLI ]
**Ajoutez des balises lors de la création d'un nouveau flux à l'aide du AWS CLI**
1. Pour créer un nouveau flux avec des balises, vous pouvez utiliser l'`propagateTags=TABLE`indicateur pour appliquer automatiquement les balises de la table au flux. Le code suivant en est un exemple.
```
aws keyspaces update-table \
--keyspace-name 'my_keyspace' \
--table-name 'my_table' \
--cdc-specification propagateTags=TABLE,status=ENABLED,viewType=NEW_IMAGE
```
1. Pour créer un nouveau flux pour une table existante et spécifier de nouvelles balises, vous pouvez utiliser l'exemple suivant.
```
aws keyspaces update-table \
--keyspace-name 'my_keyspace' \
--table-name 'my_table' \
--cdc-specification 'status=ENABLED,viewType=NEW_IMAGE,tags=[{key=tag_key, value=tag_value}]'
```
------
# Ajouter de nouveaux tags à un stream
Vous pouvez ajouter de nouvelles balises à un flux existant dans Amazon Keyspaces à l'aide du CQL ou du. AWS CLI Vous ne pouvez ajouter des tags qu'au dernier stream.
------
#### [ Console ]
**Ajouter des tags à un flux existant (console)**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**, puis choisissez la table contenant le flux que vous souhaitez baliser.
1. Choisissez l'onglet **Streams**.
1. Dans la section **Tags (Balises)** choisissez **Manage tags (Gérer les balises)**.
1. Choisissez **Ajouter un nouveau tag** pour ajouter un nouveau tag. Vous pouvez créer jusqu'à 50 balises en répétant cette étape.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Ajouter des balises à un flux à l'aide de CQL**
+ L'instruction suivante indique comment ajouter des balises à un flux existant.
```
ALTER TABLE mykeyspace.mytable ADD TAGS_FOR_CDC {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**Ajoutez des balises à un flux à l'aide du AWS CLI**
+ L'exemple suivant montre comment ajouter de nouvelles balises à un flux existant.
```
aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Supprimer des balises d'un flux
Pour supprimer des balises d'un flux, vous pouvez utiliser CQL ou le AWS CLI. Vous ne pouvez supprimer les balises que pour le dernier stream.
------
#### [ Console ]
**Supprimer des tags d'un tableau à l'aide de la console Amazon Keyspaces**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez un tableau dans la liste, puis cliquez sur l'onglet **Streams**.
1. Dans la section **Tags**, choisissez **Gérer les tags** pour supprimer les tags du tableau.
1. Après le tag que vous souhaitez supprimer, choisissez **Supprimer**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Supprimer des balises d'un flux à l'aide de CQL**
+ L'instruction suivante indique comment supprimer des balises d'un flux existant.
```
ALTER TABLE mytable DROP TAGS_FOR_CDC {'key3':'val3', 'key4':'val4'};
```
------
#### [ CLI ]
**Supprimez les balises d'un flux à l'aide du AWS CLI**
+ L'instruction suivante supprime les balises spécifiées d'un flux.
```
aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291' --tags 'key=key3,value=val3' 'key=key4,value=val4'
```
------
# Afficher les tags d'un stream
Les exemples suivants montrent comment afficher les balises d'un flux dans Amazon Keyspaces à l'aide de CQL ou du. AWS CLI
------
#### [ Console ]
**Afficher les tags d'un flux à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez un tableau dans la liste, puis cliquez sur l'onglet **Streams**.
1. Vous pouvez consulter les tags du stream dans la section **Tags**.
------
#### [ Cassandra Query Language (CQL) ]
**Afficher les balises d'un flux à l'aide de CQL**
Pour lire les balises associées à un flux, vous devez spécifier l'ARN de la ressource du flux dans la `WHERE` clause. La syntaxe CQL suivante en est un exemple.
```
SELECT * FROM system_schema_mcs.tags WHERE resource_id = stream_arn;
```
+ La requête suivante renvoie les balises pour le flux spécifié.
```
SELECT tags FROM system_schema_mcs.tags WHERE resource_id = 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-06T17:17:39.800';
```
La sortie de cette requête se présente comme suit :
```
resource_id | keyspace_name | resource_name | resource_type | tags
------------------------------------------------------------------------------------------------------------------+---------------+-------------------------+---------------+----------------------
arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-04-02T23:00:07.052 | singleks | 2025-04-02T23:00:07.052 | stream | {'tagkey': 'tagval'}
```
------
#### [ CLI ]
**Affichez les tags d'un flux à l'aide du AWS CLI**
+ Cet exemple montre comment répertorier les balises de tous les flux sous le keyspace spécifié.
```
aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291'
```
Le résultat de la dernière commande ressemble à ceci.
```
{
"tags": [
{
"key": "key1",
"value": "val1"
},
{
"key": "key2",
"value": "val2"
},
{
"key": "key3",
"value": "val3"
},
{
"key": "key4",
"value": "val4"
}
]
}
```
------
# Créez des rapports de répartition des coûts à l'aide de balises pour Amazon Keyspaces
AWS utilise des balises pour organiser les coûts des ressources dans votre rapport de répartition des coûts. AWS fournit deux types de balises de répartition des coûts :
+ Une balise AWS générée. AWS définit, crée et applique cette balise pour vous.
+ Etiquettes définies par l'utilisateur Vous définissez, créez et appliquez ces étiquettes.
Vous devez activer les deux types d'étiquettes séparément pour qu'elles apparaissent dans Cost Explorer ou sur un rapport de répartition des coûts.
Pour activer les balises AWS générées, procédez comme suit :
1. Connectez-vous à la console Billing AWS Management Console and Cost Management et ouvrez-la à l'adresse [https://console.aws.amazon.com/billing/home\$1/](https://console.aws.amazon.com/billing/home#/).
1. Dans le volet de navigation, choisissez **Balises de répartition des coûts**.
1. Sous **Identifications de répartition des coûts générées par AWS**, choisissez **Activer**.
Pour activer les étiquettes définies par l'utilisateur :
1. Connectez-vous à la console Billing AWS Management Console and Cost Management et ouvrez-la à l'adresse [https://console.aws.amazon.com/billing/home\$1/](https://console.aws.amazon.com/billing/home#/).
1. Dans le volet de navigation, choisissez **Balises de répartition des coûts**.
1. Sous **User-Defines Cost Allocation Tags (Etiquettes de répartition des coûts définies par l'utilisateur)**, choisissez **Activer**.
Après avoir créé et activé les balises, AWS génère un rapport de répartition des coûts avec votre utilisation et vos coûts regroupés en fonction de vos balises actives. Le rapport de répartition des coûts inclut tous vos AWS coûts pour chaque période de facturation. Ce rapport inclut les ressources balisées et non balisées, afin que vous puissiez organiser clairement les frais pour les ressources.
**Note**
À l'heure actuelle, les données transférées depuis Amazon Keyspaces ne sont pas ventilées par balises sur les rapports de répartition des coûts.
Pour plus d'informations, consultez [Utilisation des étiquettes d'allocation des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).