Marquer vos ressources MemoryDB - Amazon MemoryDB

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.

Marquer vos ressources MemoryDB

Pour vous aider à gérer vos clusters et autres ressources MemoryDB, vous pouvez attribuer vos propres métadonnées à chaque ressource sous forme de balises. Les balises vous permettent de classer vos AWS ressources de différentes manières, par exemple par objectif, propriétaire ou environnement. Cette approche est utile lorsque vous avez de nombreuses ressources de même type. Elle vous permet d’identifier rapidement une ressource spécifique en fonction des balises que vous lui avez attribuées. Cette rubrique décrit les balises et vous montre comment les créer.

Avertissement

Nous vous recommandons de ne pas inclure de données sensibles dans vos balises.

Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez. Les balises vous permettent de classer vos AWS ressources de différentes manières, par exemple par objectif ou par propriétaire. Par exemple, vous pouvez définir un ensemble de balises pour les clusters MemoryDB de votre compte afin de suivre le propriétaire et le groupe d'utilisateurs de chaque cluster.

Nous vous recommandons de concevoir un ensemble de clés d’étiquette répondant à vos besoins pour chaque type de ressource. L’utilisation d’un ensemble de clés de balise cohérent facilite la gestion de vos ressources. Vous pouvez rechercher et filtrer les ressources en fonction des balises que vous ajoutez. Pour plus d'informations sur la mise en œuvre d'une stratégie efficace de balisage des ressources, consultez Le livre blanc AWS sur les bonnes pratiques en matière d'identification.

Les balises n'ont aucune signification sémantique pour MemoryDB et sont interprétées strictement comme une chaîne de caractères. De plus, les étiquettes ne sont pas automatiquement affectées à vos ressources. Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. Vous pouvez définir la valeur d'une balise à null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur. Si vous supprimez une ressource, ses balises sont également supprimées.

Vous pouvez travailler avec des balises en utilisant le AWS Management Console, le AWS CLI, et le MemoryDBAPI.

Si vous en utilisezIAM, vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à créer, modifier ou supprimer des tags. Pour de plus amples informations, veuillez consulter Autorisations de niveau ressource.

Vous pouvez baliser la plupart des ressources MemoryDB qui existent déjà dans votre compte. Le tableau ci-dessous répertorie les ressources qui prennent en charge le balisage. Si vous utilisez le AWS Management Console, vous pouvez appliquer des balises aux ressources à l'aide de l'éditeur de balises. Certains écrans de ressources vous permettent de spécifier des balises pour une ressource lorsque vous la créez ; par exemple, une balise avec une clé de Nom et une valeur que vous spécifiez. Dans la plupart des cas, la console applique les balises immédiatement après la création de la ressource (plutôt qu’au cours de la création de ressources). La console peut organiser les ressources en fonction de la balise Name, mais cette balise n'a aucune signification sémantique pour le service MemoryDB.

En outre, certaines actions de création de ressources vous permettent de spécifier des balises pour une ressource lors de la création de cette dernière. Si les balises ne peuvent pas être appliquées au cours de la création de ressources, nous restaurons le processus de création de ressources. Cela permet de s’assurer que les ressources sont créées avec des balises ou qu’elles ne sont pas créées du tout, et qu’aucune ressource ne demeurent sans balise à tout moment. En attribuant des balises aux ressources au moment de la création, vous pouvez supprimer la nécessité d’exécuter des scriptes de balisage personnalisés après la création de ressources.

Si vous utilisez Amazon MemoryDBAPI, le, ou un AWS CLI AWS SDK, vous pouvez utiliser le Tags paramètre de l'APIaction MemoryDB correspondante pour appliquer des balises. Il s'agit des options suivantes :

  • CreateCluster

  • CopySnapshot

  • CreateParameterGroup

  • CreateSubnetGroup

  • CreateSnapshot

  • CreateACL

  • CreateUser

Le tableau suivant décrit les ressources MemoryDB qui peuvent être étiquetées et les ressources qui peuvent être étiquetées lors de la création à l'aide de MemoryDBAPI, de, ou d'un. AWS CLI AWS SDK

Support de balisage pour les ressources MemoryDB
Ressource Prend en charge les balises Prend en charge le balisage au moment de la création
parametergroup Oui Oui
subnetgroup Oui Oui
cluster Oui Oui
instantané Oui Oui
utilisateur Oui Oui
liste acl Oui Oui

Vous pouvez appliquer des autorisations au niveau des ressources basées sur des balises dans vos IAM politiques aux API actions MemoryDB qui prennent en charge le balisage lors de la création afin de mettre en œuvre un contrôle granulaire sur les utilisateurs et les groupes qui peuvent étiqueter les ressources lors de la création. Vos ressources sont correctement sécurisées depuis la création. Les balises sont appliquées immédiatement à vos ressources. Les autorisations de niveau ressource basées sur des balises sont donc effectives immédiatement. Vos ressources peuvent être suivies et signalées avec plus de précision. Vous pouvez appliquer l’utilisation du balisage sur les nouvelles ressources et contrôler que les clés et valeurs de balise sont définies sur vos ressources.

Pour de plus amples informations, veuillez consulter Exemple : étiquetage de vos ressources.

Pour plus d'informations sur l'étiquetage de vos ressources pour la facturation, veuillez consulter Surveillance des coûts avec des balises de répartition des coûts.

Les règles suivantes s'appliquent à l'étiquetage dans le cadre d'opérations de requête :

  • CreateCluster :

    • Si --cluster-name est fourni :

      Si des balises sont incluses dans la demande, le cluster sera balisé.

    • Si --snapshot-name est fourni :

      Si des balises sont incluses dans la demande, le cluster ne sera étiqueté qu'avec ces balises. Si aucune balise n'est incluse dans la demande, les balises de capture d'écran seront ajoutées au cluster.

  • CreateSnapshot :

    • Si --cluster-name est fourni :

      Si des balises sont incluses dans la requête, seules les balises de requête seront ajoutées à l'instantané. Si aucune balise n'est incluse dans la demande, les balises de cluster seront ajoutées à l'instantané.

    • Pour les instantanés automatiques :

      Les balises se propageront à partir des balises du cluster.

  • CopySnapshot :

    Si des balises sont incluses dans la requête, seules les balises de requête seront ajoutées à l'instantané. Si aucune balise n'est incluse dans la requête, les balises d'instantané source sont ajoutées à l'instantané copié.

  • TagResourceet UntagResource:

    Des balises seront ajoutées/supprimées de la ressource.

Les restrictions de base suivantes s’appliquent aux balises :

  • Nombre maximal de balises par ressource : 50

  • Pour chaque ressource, chaque clé de balise doit être unique, et chaque clé de balise peut avoir une seule valeur.

  • Longueur de clé maximale : 128 caractères Unicode en UTF -8.

  • Longueur maximale de la valeur : 256 caractères Unicode en UTF -8.

  • Bien que MemoryDB autorise n'importe quel caractère dans ses balises, d'autres services peuvent être restrictifs. Les caractères autorisés dans tous les services sont les suivants : lettres, chiffres et espaces représentables en UTF -8, et les caractères suivants : + - =. _ :/@

  • Les clés et valeurs d’étiquette sont sensibles à la casse.

  • Le aws: préfixe est réservé à l' AWS usage. Lorsque la balise possède une clé de balise avec ce préfixe, vous ne pouvez pas modifier ou supprimer sa clé ou sa valeur. Les balises avec le préfixe aws: ne sont pas comptabilisées comme vos balises pour la limite de ressources.

Vous ne pouvez pas mettre fin à une ressource, ou l’arrêter ou la supprimer uniquement en fonction de ses balises ; vous devez spécifier l’identificateur de ressource. Par exemple, pour supprimer des instantanés (snapshot) que vous avez balisés avec une clé de balise appelée DeleteMe, vous devez utiliser l’action DeleteSnapshot avec les identificateurs de ressource des instantanés, tels que snap-1234567890abcdef0.

Pour plus d'informations sur les ressources MemoryDB que vous pouvez baliser, consultez. Ressources que vous pouvez étiqueter

  • Ajouter des balises à un cluster.

    aws memorydb tag-resource \
--resource-arn arn:aws:memorydb:us-east-1:111111222233:cluster/my-cluster \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"

  • Création d'un cluster à l'aide de balises.

    aws memorydb create-cluster \
--cluster-name testing-tags \
--description cluster-test \
--subnet-group-name test \
--node-type db.r6g.large \
--acl-name open-access \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"

  • Création d'un instantané avec des balises.

    Dans ce cas, si vous ajoutez des balises sur demande, même si le cluster contient des balises, l'instantané ne recevra que les balises de demande. 

    aws memorydb create-snapshot \
--cluster-name testing-tags \
--snapshot-name bkp-testing-tags-mycluster \
--tags Key="work",Value="foo"