Utilisation du balisage - Guide du développeur d'Amazon Kinesis Data Analytics SQL pour applications
Ajout de balises lorsqu'une application est crééeAjout ou mise à jour des balises pour une application existanteRépertorier les balises d'une applicationSuppression des balises d'une application

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

1. À compter du 15 octobre 2025, vous ne pourrez plus créer de nouveaux Kinesis Data Analytics SQL pour les applications.

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

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

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 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 de plus amples informations, veuillez consulter Contrôle de l’accès à l’aide de balises 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.

Ajout de balises lorsqu'une application est créée

Vous pouvez ajouter des balises lors de la création d'une application à l'aide du paramètre tags de l'action CreateApplication.

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

Vous pouvez ajouter des balises à une application à l'aide de l'action TagResource. Vous ne pouvez pas ajouter de balises à une application à l'aide de l'action UpdateApplication.

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

Pour répertorier les balises existantes, utilisez l'action ListTagsForResource.

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

Pour supprimer des balises d'une application, vous devez utiliser l’action UntagResource.

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" ]
}