Étiquetage des ressources Athena

une identification est constituée d'une clé et d'une valeur que vous définissez. Lorsque vous étiquetez une ressource Athena, vous lui attribuez des métadonnées personnalisées. Vous pouvez utiliser des étiquettes pour classer vos ressources AWS de différentes manières, par exemple, par objectif, par propriétaire ou par environnement. Dans Athena, les ressources telles que les groupes de travail, les catalogues de données et les réserves de capacité sont des ressources étiquetables. Par exemple, vous pouvez créer un ensemble d'identifications pour les groupes de travail de votre compte, afin de vous aider à suivre les propriétaires de groupes de travail ou à identifier les groupes de travail grâce à leur objectif. Si vous activez également les balises en tant que balises de répartition des coûts dans la console de Billing and Cost Management, les coûts associés à l’exécution de requêtes apparaissent dans votre rapport sur les coûts et l’utilisation avec cette balise de répartition des coûts. Nous vous recommandons d’utiliser les bonnes pratiques de balisage AWS pour créer un ensemble d’identifications cohérent capable de répondre aux exigences de votre organisation.

Vous pouvez utiliser les étiquettes à l'aide de la console Athena ou des opérations d'API.

Rubriques

• Principes de base des étiquettes
• Restrictions liées aux étiquettes
• Utilisation des identifications sur des groupes de travail dans la console
• Utilisation des opérations d'identification
• Politiques de contrôle d'accès IAM basées sur les étiquettes

Principes de base des étiquettes

L'étiquette est une identification que vous attribuez à une ressource Athena. Chaque identification est constituée d'une clé et d'une valeur facultative que vous définissez.

Les étiquettes vous permettent de catégoriser vos ressources AWS de différentes manières. Par exemple, vous pouvez définir un ensemble d'identifications pour les groupes de travail de votre compte vous permettant de suivre chaque propriétaire ou objectif de groupe de travail.

Vous pouvez ajouter des étiquettes lors de la création d'un nouveau groupe de travail ou catalogue de données Athena, ou vous pouvez ajouter, modifier ou supprimer des étiquettes de ceux-ci. Vous pouvez modifier une identification dans la console. Si vous utilisez les opérations d'API, pour modifier une identification, supprimez l'ancienne et ajoutez-en une nouvelle. Si vous supprimez une ressource, les identifications associées à celle-ci seront également supprimées.

Athena n'attribue pas automatiquement d'étiquettes à vos ressources. Vous pouvez modifier les clés et valeurs d'identification, et vous pouvez retirer des identifications d'une ressource à tout moment. Vous pouvez définir la valeur d'une identification sur une chaîne vide, mais vous ne pouvez pas définir la valeur d'une identification sur null. N'ajoutez pas de clés d'identification en double à la même ressource. Dans ce cas, Athena envoie un message d'erreur. Si vous utilisez l'action TagResource pour identifier une ressource à l'aide d'une clé d'identification existante, la nouvelle valeur d'identification remplace l'ancienne valeur.

Dans IAM, vous pouvez contrôler quels utilisateurs de votre compte Amazon Web Services disposent d'autorisations de créer, modifier et supprimer ou répertorier des étiquettes. Pour plus d’informations, consultez Politiques de contrôle d'accès IAM basées sur les étiquettes.

Pour obtenir liste complète des actions des étiquettes Amazon Athena, consultez les noms des actions de l'API dans la rubrique Référence d'API Amazon Athena.

Vous pouvez utiliser des identifications pour la facturation. Pour plus d'informations, consultez la rubrique Utilisation d'identifications pour la facturation dans le guide de l'utilisateur AWS Billing and Cost Management.

Pour plus d’informations, consultez Restrictions liées aux étiquettes.

Restrictions liées aux étiquettes

les identifications disposent des restrictions suivantes :

• Dans Athena, vous pouvez étiqueter des groupes de travail et des catalogues de données. Vous ne pouvez pas identifier de requêtes.

• Le nombre maximum d'identifications par ressource est de 50. Pour rester dans la limite, vérifiez et supprimez les identifications non utilisées.

• Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur. N'ajoutez pas simultanément de clés d'identification dupliquées à la même ressource. Dans ce cas, Athena envoie un message d'erreur. Si vous identifiez une ressource à l'aide d'une clé d'identification existante en exécutant une action TagResource distincte, la nouvelle valeur d'identification remplace l'ancienne.

• La longueur de la clé d'identification est comprise entre 1 et 128 caractères Unicode en UTF-8

• La longueur de la valeur d'identification est comprise entre 0 et 256 caractères Unicode en UTF-8

  Les opérations de balisage, telles que l'ajout, la modification, la suppression ou la liste des identifications, exigent que vous spécifiez un ARN pour la ressource de groupe de travail.

• Athena vous permet d'utiliser des lettres, des chiffres, des espaces représentés en UTF-8, ainsi que les caractères suivants : + - = . _ : / @.

• Les clés et valeurs d'identification sont sensibles à la casse.

• Le préfixe "aws:" des clés d'identification est réservé à l'utilisation par AWS. Vous ne pouvez pas modifier ou supprimer des clés d'identification ayant ce préfixe. les identifications ayant ce préfixe ne sont pas comptabilisées dans votre limite d'identifications par ressource.

• Les étiquettes que vous attribuez sont disponibles uniquement pour votre compte Amazon Web Services.