Balisage des ressources Amazon Neptune

Vous pouvez utiliser des balises Neptune pour ajouter des métadonnées à vos ressources Neptune. En outre, vous pouvez utiliser des balises associées à des politiques AWS 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 Neptune peuvent être balisées, notamment 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 à une ressource Neptune. Le nom s'appelle la clé. Fournir une valeur pour la clé est facultatif. Vous pouvez utiliser des balises pour affecter 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 appelée « projet » et une valeur de balise appelée « Salix », ce qui indique que la ressource Neptune est affecté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 que environment=test ou environment=production. Nous vous recommandons d'utiliser un ensemble cohérent de clés de balise pour faciliter le suivi des métadonnées qui sont associées aux ressources Neptune.

Utilisez des balises pour organiser votre AWS facture afin de refléter votre propre structure de coûts. Pour ce faire, inscrivez-vous pour recevoir votre Compte AWS facture avec les valeurs clés du tag 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 qui sont attribué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 au niveau de cette ressource, la nouvelle valeur remplace l'ancienne.

AWS n'applique aucune signification sémantique à vos balises ; les balises sont interprétées strictement comme des chaînes de caractères. Neptune peut configurer 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 l' AWS Management Console API Neptune ou l'API Neptune pour ajouter, répertorier et supprimer des balises sur les ressources Neptune. AWS CLI Lorsque vous utilisez l'API Neptune AWS CLI ou l'API Neptune, vous devez fournir le nom de ressource Amazon (ARN) de 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 de balises sur les ressources Neptune peuvent prendre plusieurs minutes avant d'être disponibles.

Copie 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 le --tag-key paramètre de la AWS CLI commande create-db-cluster-snapshot (ou si vous fournissez au moins une balise à l'CreateDBClusterSnapshotaction 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 base 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 base de données. Après avoir créé votre instantané de base de données à l'aide de la AWS CLI create-db-cluster-snapshot commande (ou de l'action de l'API CreateDBClusterSnapshot Neptune), vous pouvez ajouter des balises comme décrit plus loin dans cette rubrique.

Marquage dans Neptune à l'aide du AWS 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 AWS de gestion et ouvrez la console Amazon Neptune à l'adresse https://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 AWS de gestion et ouvrez la console Amazon Neptune à l'adresse https://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 du AWS CLI

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

• Pour ajouter une ou plusieurs balises à une ressource Neptune, utilisez la AWS CLI commande. add-tags-to-resource

• Pour répertorier les balises d'une ressource Neptune, utilisez la AWS CLI commande. list-tags-for-resource

• Pour supprimer une ou plusieurs balises d'une ressource Neptune, utilisez la AWS CLI commande. remove-tags-from-resource

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

Balisage 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 à une ressource Neptune, utilisez l'opération AddTagsToResource.

• Pour répertorier les balises affectées à une ressource Neptune, utilisez l'opération ListTagsForResource.

• Pour supprimer des balises d'une ressource Neptune, utilisez l'opération RemoveTagsFromResource.

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 qui sont affectées à une ressource Neptune. Il ne peut y avoir qu'un ensemble de balises par ressource. Vous travaillez avec un ensemble de balises TagSet uniquement 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.