Étiquetage des ressources Amazon Neptune - Amazon Neptune

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.

Étiquetage des ressources Amazon Neptune

Vous pouvez utiliser des balises Neptune pour ajouter des métadonnées à vos ressources Neptune. De plus, vous pouvez utiliser des balises avecAWS Identity and Access Management(IAM) pour gérer l'accès aux ressources Neptune et contrôler les actions qui peuvent être appliquées à ces ressources. Enfin, vous pouvez utiliser des balises pour suivre les coûts en regroupant les dépenses pour des ressources balisées de la même façon.

Toutes les ressources administratives de Neptune peuvent être balisées, y compris les suivantes :

  • Instances DB

  • Clusters DB

  • Réplicas en lecture

  • Instantanés de base de données

  • Instantanés de cluster DB

  • Abonnements aux événements

  • Groupes de paramètres DB

  • Groupes de paramètres de cluster DB

  • Groupes de sous-réseaux DB

Présentation des balises de ressources Neptune

Une balise Amazon Neptune est une paire nom-valeur que vous définissez et associez avec une ressource Neptune. Le nom s'appelle la clé. Fournir une valeur pour la clé est facultatif. Vous pouvez utiliser des balises pour assigner des informations arbitraires à une ressource Neptune. 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 « projet » et une valeur de balise « Salix », indiquant que la ressource Neptune est assignée au projet Salix. Vous pouvez également utiliser des balises pour désigner des ressources Neptune destinées aux tests ou à la production en utilisant 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 Neptune.

Utilisez des étiquettes 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 de plus amples informations, veuillez consulter Utilisation des balises d'allocation des coûts dans le Guide de l'utilisateur AWS Billing.

Chaque ressource Neptune possède un ensemble de balises qui contient toutes les balises assignées à cette ressource Neptune. Un ensemble de balises peut contenir jusqu'à dix balises ou n'en contenir aucune. Si vous ajoutez une balise à une ressource Neptune ayant la même clé qu'une balise existante sur cette 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. Neptune peut définir des balises sur une instance de base de données ou d'autres ressources Neptune, en fonction des paramètres que vous utilisez lors de la création de la ressource. Par exemple, Neptune peut ajouter une balise indiquant qu'une instance de base de données est destinée à la production ou aux tests.

  • La clé de balise correspond au nom obligatoire de la balise. La valeur de la chaîne peut comporter de 1 à 128 caractères Unicode et elle ne peut pas être précédée de « aws: » ou de « rds: ». La chaîne peut uniquement contenir l'ensemble de lettres, de chiffres et d'espaces Unicode, « _ », « . », « / », « = », « + », « - » (regex Java : « ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$ »).

  • La valeur de balise correspond à la valeur de chaîne facultative de la balise. La valeur de la chaîne peut comporter de 1 à 256 caractères Unicode et elle ne peut pas être précédée de « aws: ». La chaîne peut uniquement contenir l'ensemble de lettres, de chiffres et d'espaces Unicode, « _ », « . », « / », « = », « + », « - » (regex Java : « ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$ »).

    Les valeurs comprises dans un ensemble de balises ne doivent pas nécessairement être uniques et peuvent être null. Par exemple, vous pouvez avoir une paire clé-valeur dans un ensemble de balises project/Trinity et cost-center/Trinity.

Note

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

Vous pouvez utiliser le pluginAWS Management Console, leAWS CLI, ou l'API Neptune pour ajouter, répertorier et supprimer des balises sur des ressources Neptune. Lors de l'utilisation duAWS CLIou l'API Neptune, vous devez fournir l'Amazon Resource Name (ARN) pour la ressource Neptune avec laquelle vous souhaitez travailler. Pour plus d'informations sur la création d'un ARN, consultez Création d'un ARN pour Neptune.

Les balises sont mises en cache à des fins d'autorisation. Pour cette raison, les ajouts et les mises à jour sur les balises sur les ressources Neptune peuvent prendre plusieurs minutes avant d'être disponibles.

Copier des balises dans Neptune

Lorsque vous créez ou restaurez une instance de base de données, vous pouvez spécifier que les balises de l'instance de base de données soient copiées vers les snapshots de l'instance de base de données. La copie des balises garantit que les métadonnées des instantanés de base de données correspondent à celles de l'instance de base de données source et que toutes les stratégies d'accès de l'instantané de base de données correspondent également à celles de l'instance de base de données source. Les balises ne sont pas copiées par défaut.

Vous pouvez spécifier que les balises soient copiées vers des snapshots DB pour les actions suivantes :

  • Création d'une instance de base de données.

  • Restauration d'une instance de base de données.

  • Création d'un réplica en lecture.

  • Copie d'un instantané de base de données.

Note

Si vous incluez une valeur pour--tag-keyparamètre decreate-db-cluster-snapshot AWS CLIcommande (ou fournissez au moins une étiquette auCreateDBClusterSnapshotAction d'API), Neptune ne copie pas les balises de l'instance de base de données source vers le nouvel instantané de base de données. C'est le cas même si l'option --copy-tags-to-snapshot (CopyTagsToSnapshot) est activée sur l'instance de base de données source.

Cela signifie que vous pouvez créer une copie d'une instance de bases de données depuis un instantané de base de données sans avoir à ajouter de balises qui ne s'appliquent pas à la nouvelle instance de bases de données. Après avoir créé votre instantané de base de données à l'aide duAWS CLI create-db-cluster-snapshotcommande (ouCreateDBClusterSnapshotNeptune API action), vous pouvez alors ajouter des balises comme décrit plus loin dans cette rubrique.

Marquage dans Neptune à l'aide duAWS Management Console

La processus de balisage d'une ressource Amazon Neptune est semblable pour toutes les ressources. La procédure suivante indique comment baliser une instance de base de données Neptune.

Pour ajouter une balise à une instance de base de données

  1. Connectez-vous à la console.AWSConsole de gestion et ouvrez la console Amazon Neptune à l'adressehttps://console.aws.amazon.com/neptune/home.

  2. Dans le panneau de navigation, sélectionnez Instances.

    Note

    Pour filtrer la liste des instances de base de données dans le volet Instances, saisissez une chaîne de texte dans la zone Filtrer les instances. Seules les instances de base de données qui contiennent la chaîne apparaissent.

  3. Choisissez l'instance de base de données que vous voulez baliser.

  4. Choisissez Actions d'instance, puis Voir les informations

  5. Dans la section des détails, faites défiler jusqu'à la section Balises.

  6. Choisissez Ajouter. La fenêtre Ajouter des balises s'affiche.

  7. Saisissez une valeur pour Clé de balise et Valeur.

  8. Pour ajouter une autre balise, vous pouvez choisir Ajouter une autre balise et saisir une valeur pour Clé de balise et Valeur.

    Répétez cette étape autant de fois que nécessaire.

  9. Choisissez Ajouter.

Pour supprimer une balise d'une instance de base de données

  1. Connectez-vous à la console.AWSConsole de gestion et ouvrez la console Amazon Neptune à l'adressehttps://console.aws.amazon.com/neptune/home.

  2. Dans le panneau de navigation, sélectionnez Instances.

    Note

    Pour filtrer la liste des instances de base de données dans le volet Instances, saisissez une chaîne de texte dans la zone Filtrer les instances. Seules les instances de base de données qui contiennent la chaîne apparaissent.

  3. Choisissez l'instance de base de données que vous voulez baliser.

  4. Choisissez Actions d'instance, puis Voir les informations

  5. Dans la section des détails, faites défiler jusqu'à la section Balises.

  6. Choisissez la balise que vous souhaitez supprimer.

  7. Choisissez Supprimer, et choisissez Supprimer dans la fenêtre Supprimer des balises.

Marquage dans Neptune à l'aide duAWS CLI

Vous pouvez ajouter, répertorier ou supprimer des balises pour une instance de base de données dans Neptune à l'aide de laAWS CLI.

Pour en savoir plus sur la création de l'Amazon Resource Name (ARN) requis, consultez Création d'un ARN pour Neptune.

Marquage dans Neptune à l'aide de l'API

Vous pouvez ajouter, répertorier ou supprimer des balises pour une instance de base de données à l'aide de l'API Neptune.

  • Pour ajouter une balise Neptune tune tune tune tune tune tune tune tune tune tune tune tune tuneAddTagsToResourceUsage operation.

  • Pour répertorier des balises assignées à une ressource Neptune, utilisezListTagsForResource.

  • Pour supprimer des balises d'une ressource Neptune, utilisez leRemoveTagsFromResourceUsage operation.

Pour en savoir sur la création de l'ARN requis, consultez Création d'un ARN pour Neptune.

Lorsque vous travaillez avec XML à l'aide de l'API Neptune, les balises utilisent le schéma suivant :

<Tagging> <TagSet> <Tag> <Key>Project</Key> <Value>Trinity</Value> </Tag> <Tag> <Key>User</Key> <Value>Jones</Value> </Tag> </TagSet> </Tagging>

Le tableau suivant fournit une liste des balises XML autorisées et leurs caractéristiques. Les valeurs de Key et Value sont sensibles à la casse. Par exemple, project=Trinity et PROJECT=Trinity sont deux balises différentes.

Élément de balisage Description
TagSet Un ensemble de balises contient toutes les balises assignées à une ressource Neptune. Il ne peut y avoir qu'un ensemble de balises par ressource. Vous travaillez avecTagSetuniquement via l'API Neptune.
Tag Une balise est une paire clé-valeur définie par l'utilisateur. Il peut y avoir de 1 à 50 balises dans un ensemble de balises.
Key

Une clé est le nom obligatoire de la balise. La valeur de la chaîne peut comporter de 1 à 128 caractères Unicode et elle ne peut pas être précédée de « rds: » ou de « aws: ». La chaîne peut uniquement contenir l'ensemble de lettres, de chiffres et d'espaces Unicode, « _ », « . », « / », « = », « + », « - » (regex Java : « ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$ »).

Les clés doivent être propres à un ensemble de balises. Par exemple, vous ne pouvez pas avoir une paire de clés dans un ensemble de balises avec la même clé mais des valeurs différentes, comme project/Trinity et project/Xanadu.

Valeur

Une valeur est la valeur facultative de la balise. La valeur de la chaîne peut comporter de 1 à 256 caractères Unicode et elle ne peut pas être précédée de « rds: » ou de « aws: ». La chaîne peut uniquement contenir l'ensemble de lettres, de chiffres et d'espaces Unicode, « _ », « . », « / », « = », « + », « - » (regex Java : « ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$ »).

Les valeurs comprises dans un ensemble de balises ne doivent pas nécessairement être uniques et peuvent être null. Par exemple, vous pouvez avoir une paire clé-valeur dans un ensemble de balises project/Trinity et cost-center/Trinity.