Balisage des ressources dans AWS Database Migration Service - AWS Service de Migration de Base de Données
API

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.

Balisage des ressources dans AWS Database Migration Service

Vous pouvez utiliser des balises dans AWS Database Migration Service (AWS DMS) pour ajouter des métadonnées à vos ressources. De plus, ces balises peuvent être utilisées avec des politiques AWS Identity and Access Management (IAM) pour gérer l'accès aux ressources AWS DMS et contrôler les actions qui peuvent être appliquées aux ressources AWS DMS. Enfin, vous pouvez utiliser ces 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 AWS DMS peuvent être balisées :

  • Certificats

  • Fournisseurs de données

  • Migrations de données

  • Points de terminaison

  • Abonnements aux événements

  • Profils d'instance

  • Projets de migration

  • Instances de réplication

  • Groupes de sous-réseaux de réplication

  • Tâches de réplication

Une balise AWS DMS est une paire nom-valeur que vous définissez et associez à une ressource AWS DMS. 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 AWS DMS. Une clé de balise peut être utilisée, 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 AWS DMS est affectée au projet Salix. Vous pouvez également utiliser des balises pour indiquer que des ressources AWS DMS sont utilisées pour des tests ou en production en utilisant une clé telle que environnement=test ou environnement =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 AWS DMS.

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 AWS DMS possède un ensemble de balises qui contient toutes les balises affectées à cette ressource AWS DMS. Un ensemble de balises peut contenir jusqu'à dix balises ou n'en contenir aucune. Si vous ajoutez une balise à une ressource AWS DMS ayant la même clé qu'une balise existante sur cette ressource, la nouvelle valeur remplace l'ancienne.

AWS n'applique aucune signification sémantique aux balises ; celles-ci sont interprétées strictement comme des chaînes de caractères. AWS DMS peut définir des balises sur une ressource AWS DMS, en fonction des paramètres que vous utilisez lorsque vous créez la ressource.

La liste ci-dessous décrit les caractéristiques d'une balise AWS DMS.

  • 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 ne peut pas être précédée de « aws: » ou « dms: ». 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 ne peut pas être précédée de « aws: » ou « dms: ». 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 appelé projet/Trinity et centre-de-coûts/Trinity.

Vous pouvez utiliser AWS CLI ou l'API AWS DMS pour ajouter, répertorier et supprimer les balises sur les ressources AWS DMS. Lorsque vous utilisez AWS CLI ou l'API AWS DMS, vous devez fournir l'Amazon Resource Name (ARN) pour la ressource AWS DMS avec laquelle vous souhaitez travailler. Pour plus d'informations sur la création d'un ARN, consultez Création d'un nom de ressource Amazon (ARN) pour AWS DMS.

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

API

Vous pouvez ajouter, répertorier ou supprimer des balises pour une ressource AWS DMS à l'aide de l'API AWS DMS.

  • Pour ajouter une balise à une ressource AWS DMS, utilisez l'opération AddTagsToResource.

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

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

Pour en savoir sur la création de l'ARN requis, consultez Création d'un nom de ressource Amazon (ARN) pour AWS DMS.

Lorsque vous travaillez avec XML à l'aide de l'API AWS DMS, 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. Notez que les valeurs pour la clé et la valeur sont sensibles à la casse. Par exemple, projet=Trinity et PROJET=Trinity sont deux balises différentes.

Elément de balisage Description
TagSet Un ensemble de balises contient toutes les balises assignées à une ressource Amazon RDS. Il ne peut y avoir qu'un ensemble de balises par ressource. Vous travaillez avec un TagSet uniquement via l'API AWS DMS.
Tag Une balise est une paire clé-valeur définie par l'utilisateur. Il peut y avoir de 1 à 10 balises dans un ensemble de balises.
Clé

Une clé est le nom obligatoire de la balise. La valeur de la chaîne peut comporter de 1 à 128 caractères Unicode et ne peut pas être précédée de « dms: » ou « 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-clé dans un ensemble de balises avec la clé identique mais des valeurs différentes comme projet/Trinity et projet/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 ne peut pas être précédée de « dms: » ou « 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 appelé projet/Trinity et centre-de-coûts/Trinity.