Balisage des ressources Amazon Aurora Global Database

Cette fonctionnalité vous permet d’appliquer des balises RDS aux ressources à différents niveaux au sein d’une base de données globale. Si vous ne savez pas comment les balises sont utilisées avec les ressources AWS ou Aurora, consultez Marquage des ressources Amazon Aurora et Amazon RDS avant d’appliquer des balises dans votre base de données globale.

Vous pouvez appliquer des balises aux types de ressources suivants dans une base de données globale :

Voici quelques exemples des types de balises que vous pouvez attribuer dans une base de données globale :

Exemples de balisage des bases de données globales avec l’AWS CLI

Les exemples suivants de l’AWS CLI montrent comment vous pouvez spécifier et examiner les balises pour tous les types de ressources Aurora dans votre base de données globale.

Vous pouvez spécifier des balises pour le conteneur de cluster global à l’aide de la commande create-global-cluster. L’exemple suivant crée un cluster global et lui attribue deux balises. Ces balises ont les clés tag1 et tag2.

$  aws rds create-global-cluster --global-cluster-identifier my_global_cluster_id \
  --engine aurora-mysql --tags Key=tag1,Value=val1 Key=tag2,Value=val2

Vous pouvez répertorier les balises du conteneur de cluster global à l’aide de la commande describe-global-clusters. Lorsque vous utilisez des balises, vous exécutez généralement d’abord la commande permettant de récupérer l’Amazon Resource Name (ARN) du cluster global. Vous utiliserez cet ARN comme paramètre dans les commandes suivantes pour travailler avec les balises. La commande suivante affiche les informations de balise dans l’attribut TagList. Elle montre également l’ARN, qui sera utilisé comme paramètre dans les exemples suivants.

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            "GlobalClusterArn": "my_global_cluster_arn",
            ...
            "TagList": [
                {
                    "Value": "val1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                }
            ]
        }
    ]
}

Vous pouvez ajouter de nouvelles balises à l’aide de la commande add-tags-to-resource. Avec cette commande, vous spécifiez l’Amazon Resource Name (ARN) du cluster global plutôt que son identifiant. L’ajout d’une balise ayant le même nom qu’une balise existante remplace la valeur de cette balise. Si vous incluez des espaces ou des caractères spéciaux dans les valeurs des balises, citez ces valeurs de manière appropriée en fonction de votre système d’exploitation ou de votre shell de commande. L’exemple suivant modifie les balises du cluster global de l’exemple précédent. À l’origine, les balises du cluster avaient les clés tag1 et tag2. Une fois la commande terminée, le cluster global a une nouvelle balise avec clé tag3, et la balise avec la clé tag1 a une valeur différente.

$  aws rds add-tags-to-resource --resource-name my_global_cluster_arn \
  --tags Key=tag1,Value="new value for tag1" Key=tag3,Value="entirely new tag"

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                },
                {
                    "Value": "entirely new tag",
                    "Key": "tag3"
                }
            ]
        }
    ]
}

Vous pouvez supprimer une balise du cluster global à l’aide de la commande remove-tags-from-resource. Avec cette commande, vous spécifiez uniquement un ensemble de clés de balise, sans aucune valeur de balise. L’exemple suivant modifie les balises du cluster global de l’exemple précédent. À l’origine, les balises du cluster avaient les clés tag1, tag2 et tag3. Une fois la commande terminée, il ne reste que la balise avec la clé tag1.

$  aws rds remove-tags-from-resource --resource-name my_global_cluster_arn --tag-keys tag2 tag3

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                }
            ]
        }
    ]
}