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.
# Ajout de balises et d’étiquettes aux ressources dans DynamoDB
Vous pouvez libeller des ressources Amazon DynamoDB à l’aide d’*étiquettes*. Les balises vous permettent de classer vos ressources de différentes manières, par exemple, par objectif, par propriétaire, par environnement ou selon 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.
+ Voir AWS les factures ventilées par tags.
**Note**
Les index secondaires locaux (LSI) et les index secondaires globaux (GSI) associés aux tables balisées sont étiquetés avec les mêmes balises automatiquement. Actuellement, l’utilisation DynamoDB Streams ne peut pas être étiquetée.
Le balisage est pris en charge par AWS des services tels qu'Amazon EC2, Amazon S3, DynamoDB, 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 d’étiquetage dans DynamoDB](#TaggingRestrictions).
1. Créer des balises en utilisant [Étiquetage de ressources dans DynamoDB](Tagging.Operations.md).
1. [Utilisation des balises DynamoDB pour créer des rapports de répartition des coûts](#CostAllocationReports)À 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 d’étiquetage dans DynamoDB
Chaque étiquette est constituée d’une clé et d’une valeur, que vous définissez. Les restrictions suivantes s’appliquent :
+ Chaque table DynamoDB ne peut avoir qu’une seule étiquette 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 clés et les valeurs des balises distinguent les majuscules et minuscules.
+ 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.
+ La taille maximale prise en charge pour toutes les balises d’une table est de 10 Ko.
+ 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 ni dans la limite de taille maximale de 10 Ko. 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.
# Étiquetage de ressources dans DynamoDB
Vous pouvez utiliser la console Amazon DynamoDB ou AWS Command Line Interface le AWS CLI() pour ajouter, répertorier, modifier ou supprimer des balises. Vous pouvez ensuite activer ces balises définies par l’utilisateur afin de les faire apparaître sur la console AWS Billing and Cost Management pour le suivi de la répartition des coûts. Pour de plus amples informations, veuillez consulter [Utilisation des balises DynamoDB pour créer des rapports de répartition des coûts](Tagging.md#CostAllocationReports).
Pour la modification en bloc, vous pouvez également utiliser l’éditeur d’étiquettes sur l’ AWS Management Console. Pour plus d’informations, consultez [Utilisation de Tag Editor](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html).
Pour utiliser l’API DynamoDB à la place, découvrez les opérations suivantes dans la [Référence d’API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/) :
+ [TagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UntagResource.html)
+ [ListTagsOfResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTagsOfResource.html)
**Topics**
+ [Définition d’autorisations pour filtrer par étiquettes](#Tagging.Operations.permissions)
+ [Ajout d’étiquettes à des tables nouvelles ou existantes (AWS Management Console)](#Tagging.Operations.using-console)
+ [Ajout d'étiquettes à des tables nouvelles ou existantes (AWS CLI)](#Tagging.Operations.using-cli)
## Définition d’autorisations pour filtrer par étiquettes
Pour utiliser des étiquettes afin de filtrer votre liste de tables dans la console DynamoDB, assurez-vous que les politiques de votre utilisateur incluent l’accès aux opérations suivantes :
+ `tag:GetTagKeys`
+ `tag:GetTagValues`
Pour accéder à ces opérations en attachant une nouvelle politique IAM à votre utilisateur, suivez les étapes ci-dessous.
1. Accédez à la [console IAM](https://console.aws.amazon.com/iam/) avec un utilisateur administrateur.
1. Dans le menu de navigation à gauche, sélectionnez « Policies (politiques) ».
1. Sélectionnez « Create Policy (Créer une politique) ».
1. Collez le politique suivante dans l’éditeur JSON.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"tag:GetTagKeys",
"tag:GetTagValues"
],
"Resource": "*"
}
]
}
```
------
1. Suivez la procédure de l’Assistant et attribuez un nom à la politique (par exemple, `TagKeysAndValuesReadAccess`).
1. Dans le menu de navigation de gauche, sélectionnez « Users (Utilisateurs) ».
1. Dans la liste, sélectionnez l’utilisateur que vous utilisez normalement pour accéder à la console DynamoDB.
1. Sélectionnez « Add permissions (Ajouter des autorisations) ».
1. Sélectionnez « Attach existing policies directly (Attacher directement des politiques existantes) ».
1. Dans la liste, sélectionnez la politique que vous avez créée précédemment.
1. Exécutez l’assistant.
## Ajout d’étiquettes à des tables nouvelles ou existantes (AWS Management Console)
Vous pouvez utiliser la console DynamoDB pour ajouter des étiquettes à de nouvelles tables lors de leur création, ou ajouter, modifier ou supprimer des étiquettes pour des tables existantes.
**Pour baliser des ressources lors de leur création (console)**
1. Connectez-vous à la console DynamoDB AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. Dans le panneau de navigation, choisissez **Tables**, puis **Create table (Créer une table)**.
1. Sur la page **Create DynamoDB table (Créer une table DynamoDB)**, fournissez un nom et une clé primaire. Dans **Identifications**, choisissez **Ajouter une nouvelle identification** et saisissez les identifications que vous souhaitez utiliser.
Pour plus d’informations sur la structure des balises, consultez [Restrictions d’étiquetage dans DynamoDB](Tagging.md#TaggingRestrictions).
Pour plus d’informations sur la création de tables, consultez [Opérations de base sur les tables DynamoDB](WorkingWithTables.Basics.md).
**Pour baliser des ressources existantes (console)**
Ouvrez la console DynamoDB à l'adresse. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. Dans le volet de navigation, choisissez **Tables**.
1. Choisissez une table dans la liste, puis choisissez l’onglet **Paramètres supplémentaires**. Vous pouvez ajouter, modifier ou supprimer vos identifications dans la section **Identifications** en bas de la page.
## Ajout d'étiquettes à des tables nouvelles ou existantes (AWS CLI)
Les exemples suivants montrent comment utiliser le AWS CLI pour spécifier des balises lorsque vous créez des tables et des index, et pour étiqueter des ressources existantes.
**Pour baliser des ressources lors de leur création (AWS CLI)**
+ L’exemple suivant crée une nouvelle table `Movies` et ajoute la balise `Owner` avec la valeur `blueTeam` :
```
aws dynamodb create-table \
--table-name Movies \
--attribute-definitions AttributeName=Title,AttributeType=S \
--key-schema AttributeName=Title,KeyType=HASH \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--tags Key=Owner,Value=blueTeam
```
**Pour baliser des ressources existantes (AWS CLI)**
+ L’exemple suivant ajoute la table `Owner` avec la valeur `blueTeam` pour la table `Movies` :
```
aws dynamodb tag-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies \
--tags Key=Owner,Value=blueTeam
```
**Pour répertorier toutes les balises pour une table (AWS CLI)**
+ L’exemple suivant répertorie toutes les balises associées à la table `Movies` :
```
aws dynamodb list-tags-of-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies
```
## Utilisation des balises DynamoDB pour créer des rapports de répartition des coûts
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 :
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**
Actuellement, les données transférées à partir de DynamoDB ne sont pas réparties par étiquettes 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).