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

Pour les nouveaux projets, nous vous recommandons d'utiliser le nouveau service géré pour Apache Flink Studio plutôt que Kinesis Data Analytics SQL for Applications. Le service géré pour Apache Flink Studio allie facilité d’utilisation et capacités analytiques avancées, ce qui vous permet de créer des applications sophistiquées de traitement des flux en quelques minutes.

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