Balisage des ressources Amazon DocumentDB

Vous pouvez utiliser les balises Amazon DocumentDB (compatibles avec MongoDB) pour ajouter des métadonnées à vos ressources Amazon DocumentDB. Ces balises peuvent être utilisées avecAWS Identity and Access Managementpolitiques (IAM) pour gérer l'accès aux ressources Amazon DocumentDB et pour contrôler les actions qui peuvent être appliquées aux ressources. Vous pouvez également utiliser ces balises pour suivre les coûts en regroupant les dépenses pour des ressources balisées de la même façon.

Vous pouvez baliser les ressources Amazon DocumentDB suivantes :

• Clusters

• instances

• Instantanés

• Instantanés de cluster

• Groupes de paramètres

• Groupes de paramètres de cluster

• Groupes de sécurité

• Groupes de sous-réseaux

Présentation des balises de ressources Amazon DocumentDB

Une balise Amazon DocumentDB est une paire nom-valeur que vous définissez et associez à une ressource Amazon DocumentDB. Le nom s'appelle la clé. Fournir une valeur pour la clé est facultatif. Vous pouvez utiliser des balises pour attribuer des informations arbitraires à une ressource Amazon DocumentDB. Vous pouvez utiliser une clé de balise, par exemple, pour définir une catégorie, et la valeur de balise peut être un élément de cette catégorie. Par exemple, vous pouvez définir une clé de balise deprojectet une valeur de balise deSalix, indiquant que la ressource Amazon DocumentDB est affectée au projet Salix. Vous pouvez également utiliser des balises pour désigner les ressources Amazon DocumentDB comme étant utilisées à des fins de test ou de production à l'aide d'une clé telle queenvironment=testouenvironment=production. Nous vous recommandons d'utiliser un ensemble cohérent de clés de balise pour faciliter le suivi des métadonnées associées aux ressources Amazon DocumentDB.

Vous pouvez utiliser des balises pour organiser votre facture AWS afin de refléter votre propre structure de coût. Pour ce faire, inscrivez-vous pour obtenir votre facture Compte AWS avec les valeurs de clé de balise incluses. Ensuite, pour voir le coût de vos ressources combinées, organisez vos informations de facturation en fonction des ressources possédant les mêmes valeurs de clé de balise. Par exemple, vous pouvez baliser plusieurs ressources avec un nom d'application spécifique, puis organiser vos informations de facturation pour afficher le coût total de cette application dans plusieurs services. Pour plus d'informations, voirUtilisation des balises de répartition des coûtsdans leAWSGuide de l'utilisateur sur la facturation et la gestion des coûts.

Chaque ressource Amazon DocumentDB possède un ensemble de balises, qui contient toutes les balises attribuées à cette ressource. Un ensemble de balises peut contenir jusqu'à dix balises ou n'en contenir aucune. Si vous ajoutez une balise à une ressource Amazon DocumentDB qui possède la même clé qu'une balise existante sur la ressource, la nouvelle valeur remplace l'ancienne valeur.

AWS n'applique aucune signification sémantique aux balises ; celles-ci sont interprétées strictement comme des chaînes de caractères. Amazon DocumentDB peut définir des balises sur une instance ou d'autres ressources Amazon DocumentDB, en fonction des paramètres que vous utilisez lors de la création de la ressource. Par exemple, Amazon DocumentDB peut ajouter une balise indiquant qu'une instance est destinée à la production ou aux tests.

Vous pouvez ajouter une balise à un instantané, toutefois, votre facture ne reflètera pas ce groupement.

Vous pouvez utiliserAWS Management Consoleou leAWS CLIpour ajouter, répertorier et supprimer des balises sur les ressources Amazon DocumentDB. Lorsque vous utilisez la AWS CLI, vous devez fournir l'Amazon Resource Name (ARN) pour la ressource avec laquelle vous souhaitez travailler. Pour plus d'informations sur les ARN Amazon DocumentDB, consultezComprendre les noms de ressources Amazon (ARN) Amazon DocumentDB.

Restrictions liées aux balises

Les contraintes suivantes s'appliquent aux balises Amazon DocumentDB :

• Nombre maximum de balises par ressource : 10

• Longueur de Key maximale - 128 caractères Unicode.

• Longueur de valeur maximale - 256 caractères Unicode.

• Caractères valables pour Clé et Valeur - lettres majuscules et minuscules UTF-8, chiffres, espace et les caractères suivants : _ . : / = + - et @ (Java regex : "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")

• Les clés et valeurs de balise sont sensibles à la casse.

• Le préfixe aws: ne peut pas être utilisé pour les valeurs ou clés de balise ; il est réservé à AWS.

Ajouter et mettre à jour des balises sur une ressource Amazon DocumentDB

Vous pouvez ajouter jusqu'à 10 balises à une ressource à l'aide duAWS Management Consoleou leAWS CLI.

Using the AWS Management Console

Le processus d'ajout d'une balise à une ressource est semblable, quelle que soit la ressource à laquelle vous ajoutez la balise. Dans cet exemple, vous ajoutez une balise à un cluster.

Ajouter ou mettre à jour des balises à un cluster à l'aide de la console

1. Connectez-vous auAWS Management Console, et ouvrez la console Amazon DocumentDB à l'adressehttps://console.aws.amazon.com/docdb.

2. Dans le volet de navigation, choisissez clusters.

3. Choisissez le nom du cluster auquel vous souhaitez ajouter des balises.

4. Faites défiler jusqu'à la section Balises, puis choisissez Modifier.

5. Pour chaque balise que vous souhaitez ajouter à cette ressource, procédez comme suit :

   1. Pour ajouter une nouvelle balise, saisissez le nom de la balise dans la case Clé. Pour modifier la valeur d'une balise, recherchez le nom de la balise dans la colonne Clé.

   2. Pour doter la balise d'une valeur nouvelle ou mise à jour, saisissez une valeur pour la balise dans la case Valeur.

   3. Pour ajouter davantage de balises, choisissez Ajouter. Lorsque vous avez terminé, choisissez Sauvegarder.

Using the AWS CLI

Le processus d'ajout d'une balise à une ressource est semblable, quelle que soit la ressource à laquelle vous ajoutez la balise. Dans cet exemple, vous ajoutez trois balises à un cluster. La deuxième balise, key2, n'a pas de valeur.

Avec l'opération AWS CLI, utilisez ces paramètres add-tags-to-resource.

Paramètres

• --resource-name: l'ARN de la ressource Amazon DocumentDB à laquelle vous souhaitez ajouter des balises.

• --tags—Liste les balises (paire clé-valeur) que vous souhaitez ajouter à cette ressource au formatKey=key-name,Value=tag-value.

Pour Linux, macOS ou Unix :

aws docdb add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Pour Windows :

aws docdb add-tags-to-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

L'opération add-tags-to-resource ne produit aucun résultat. Pour consulter les résultats de l'opération, utilisez l'opération list-tags-for-resource.

Répertorier des balises sur une ressource Amazon DocumentDB

Vous pouvez utiliserAWS Management Consoleou leAWS CLIpour obtenir la liste des balises d'une ressource Amazon DocumentDB.

Using the AWS Management Console

Le processus pour établir une liste de balises pour une ressource est semblable, quelle que soit la ressource à laquelle vous ajoutez la balise. Dans cet exemple, vous établissez la liste des balises pour un cluster.

Établir la liste des balises pour un cluster à l'aide de la console

1. Ouvrez la console Amazon DocumentDB à l'adressehttps://console.aws.amazon.com/docdb.

2. Dans le volet de navigation, choisissez clusters.

3. Choisissez le nom du cluster pour lequel vous souhaitez établir la liste des balises.

4. Pour afficher la liste des balises pour cette ressource, faites défiler vers le bas jusqu'à la section Balises.

Using the AWS CLI

Le processus pour établir une liste de balises pour une ressource est semblable, quelle que soit la ressource pour laquelle vous établissez la liste des balises. Dans cet exemple, vous établissez la liste des balises pour un cluster.

Avec l'opération AWS CLI, utilisez ces paramètres list-tags-for-resource.

Paramètres

• --resource-name : obligatoire. L'ARN de la ressource Amazon DocumentDB pour laquelle vous souhaitez répertorier les balises.

Pour Linux, macOS ou Unix :

aws docdb list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Pour Windows :

aws docdb list-tags-for-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

La sortie de cette opération ressemble à ceci (format JSON).

{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": ""
        },
        {
            "Key": "key3",
            "Value": "value3"
        }
    ]
}

Supprimer des balises d'une ressource Amazon DocumentDB

Vous pouvez utiliserAWS Management Consoleou leAWS CLIpour supprimer les balises des ressources Amazon DocumentDB.

Using the AWS Management Console

Le processus de suppression de balises dans une ressource est semblable, quelle que soit la ressource dans laquelle vous voulez supprimer la balise. Dans cet exemple, vous supprimez des balises dans un cluster.

Pour supprimer les balises d'un cluster à l'aide de la console

1. Ouvrez la console Amazon DocumentDB à l'adressehttps://console.aws.amazon.com/docdb.

2. Dans le volet de navigation, choisissez clusters.

3. Choisissez le nom du cluster pour lequel vous souhaitez supprimer des balises.

4. Faites défiler jusqu'à la section Balises, puis choisissez Modifier.

5. Si vous souhaitez supprimer toutes les balises de cette ressource, choisissez Tout supprimer. Dans le cas contraire, pour chaque balise que vous souhaitez supprimer dans cette ressource, procédez comme suit :

   1. Recherchez le nom de la balise dans la colonne Clé.

   2. Choisissez Supprimer sur la même ligne que la clé de la balise.

   3. Lorsque vous avez terminé, choisissez Save (Sauvegarder).

Using the AWS CLI

Le processus de suppression d'une balise dans une ressource est semblable, quelle que soit la ressource dans laquelle vous voulez supprimer la balise. Dans cet exemple, vous supprimez une balise dans un cluster.

Avec l'opération AWS CLI, utilisez ces paramètres remove-tags-from-resource.

• --resource-name : obligatoire. L'ARN de la ressource Amazon DocumentDB dont vous souhaitez supprimer les balises.

• --tag-keys : obligatoire. Liste des clés des balises que vous voulez supprimer dans cette ressource.

Pour Linux, macOS ou Unix :

aws docdb remove-tags-from-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

Pour Windows :

aws docdb remove-tags-from-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

L'opération removed-tags-from-resource ne produit aucun résultat. Pour consulter les résultats de l'opération, utilisez l'opération list-tags-for-resource.