Après mûre réflexion, nous avons décidé de mettre fin à Amazon Kinesis Data Analytics pour les applications SQL :

1. À compter du **1er septembre 2025,** nous ne fournirons aucune correction de bogue pour les applications Amazon Kinesis Data Analytics for SQL, car leur support sera limité, compte tenu de l'arrêt prochain.

2. À compter du **15 octobre 2025,** vous ne pourrez plus créer de nouvelles applications Kinesis Data Analytics for SQL.

3. Nous supprimerons vos candidatures à compter **du 27 janvier 2026**. Vous ne serez pas en mesure de démarrer ou d'utiliser vos applications Amazon Kinesis Data Analytics for SQL. Support ne sera plus disponible pour Amazon Kinesis Data Analytics for SQL à partir de cette date. Pour de plus amples informations, veuillez consulter [Arrêt d'Amazon Kinesis Data Analytics pour les applications SQL](discontinuation.md).

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 du balisage
<a name="how-tagging"></a>

Cette section décrit comment ajouter des balises de métadonnées clé-valeur à des applications Kinesis Data Analytics. Ces balises peuvent être utilisées aux fins suivantes :
+ Déterminer la facturation pour les applications Kinesis Data Analytics individuelles. Pour plus d’informations, consultez [Utilisation des balises de répartition des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le *Guide de l’utilisateur AWS Billing and Cost Management*.
+ Contrôle de l'accès aux ressources d’application basé sur des balises. Pour plus d’informations, consultez [Contrôle de l’accès à l’aide de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dans le *Guide de l’utilisateur*.
+ À des fins définies par l'utilisateur. Vous pouvez définir des fonctionnalités d'application en fonction de la présence de balises utilisateur.

Notez les informations suivantes concernant le balisage :
+ Le nombre maximal de balises d'application inclut les balises système. Le nombre maximal de balises d'application définies par l'utilisateur est de 50.
+ Si une action inclut une liste de balises qui comporte des valeurs `Key` en double, le service émet une `InvalidArgumentException`.

**Topics**
+ [Ajout de balises lorsqu'une application est créée](#how-tagging-create)
+ [Ajout ou mise à jour des balises pour une application existante](#how-tagging-add)
+ [Répertorier les balises d'une application](#how-tagging-list)
+ [Suppression des balises d'une application](#how-tagging-remove)

## Ajout de balises lorsqu'une application est créée
<a name="how-tagging-create"></a>

Vous ajoutez des balises lors de la création d'une application en utilisant le `tags` paramètre de l'[CreateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_CreateApplication.html)action.

L'exemple de demande suivant illustre le nœud `Tags` pour une demande `CreateApplication` :

```
"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]
```

## Ajout ou mise à jour des balises pour une application existante
<a name="how-tagging-add"></a>

Vous pouvez ajouter des balises à une application à l'aide de l'[TagResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_TagResource.html)action. Vous ne pouvez pas ajouter de balises à une application à l'aide de [UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)cette action.

Pour mettre à jour une balise existante, ajoutez une balise avec la même clé que la balise existante.

L'exemple de demande suivant pour l'action `TagResource` ajoute de nouvelles balises ou met à jour des balises existantes :

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}
```

## Répertorier les balises d'une application
<a name="how-tagging-list"></a>

Pour répertorier les balises existantes, vous utilisez l'[ListTagsForResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_ListTagsForResource.html)action.

L'exemple de demande suivant pour l'action `ListTagsForResource` répertorie les balises pour une application :

```
{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication"
}
```

## Suppression des balises d'une application
<a name="how-tagging-remove"></a>

Pour supprimer des balises d'une application, vous devez utiliser l'[UntagResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UntagResource.html)action.

L’exemple de requête suivant pour l’action `UntagResource` supprime des balises d’une application :

```
{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}
```