Marquage dans Neptune à l'aide de l'API - 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.

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 à 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.

Value

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.