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.

Baliser des groupes et des instances Auto Scaling

Une balise est une étiquette d'attribut personnalisée que vous attribuez ou attribuez à une AWS ressource. AWS Chaque balise se compose de deux parties :

Les balises vous permettent d’effectuer les actions suivantes :

Vous pouvez baliser les groupes Auto Scaling nouveaux ou existants. Vous pouvez également propager les balises d'un groupe Auto Scaling aux instances EC2 qu'il lance.

Les balises ne sont pas propagées aux volumes Amazon EBS. Pour ajouter des balises aux volumes Amazon EBS, spécifiez les balises dans un modèle de lancement. Pour plus d’informations, consultez Créer un modèle de lancement pour un groupe Auto Scaling.

Vous pouvez créer et gérer des balises via AWS Management Console le ou AWS CLI les SDK.

Limites d'utilisation et de dénomination des balises

Les restrictions de base suivantes s'appliquent aux balises :

Cycle de vie de balisage d'instance EC2

Si vous avez choisi de propager des balises vers vos instances EC2, celles-ci sont gérées comme suit :

Baliser vos groupes Auto Scaling

Lorsque vous ajoutez une balise au groupe Auto Scaling, vous pouvez spécifier si elle doit être ajoutée aux instances lancées dans le groupe Auto Scaling. Si vous modifiez une balise, la version mise à jour de la balise est ajoutée aux instances lancées dans le groupe Auto Scaling après le changement. Si vous créez ou modifiez une balise pour un groupe Auto Scaling, ces changements ne sont pas appliqués aux instances déjà en cours d'exécution dans le groupe Auto Scaling.

Ajouter ou modifier des balises (console)

Pour étiqueter un groupe Auto Scaling lors de la création

Lorsque vous utilisez la console Amazon EC2 pour créer un groupe Auto Scaling, vous pouvez spécifier les clés et les valeurs des balises sur la page Add tags (Ajouter des balises) de l'assistant Create Auto Scaling group (Créer un groupe Auto Scaling). Pour propager une balise aux instances lancées dans le groupe Auto Scaling, assurez-vous que vous conservez l'option Tag new instances (Baliser les nouvelles instances) pour cette balise sélectionnée. Sinon, vous pouvez la désactiver.

Ajouter ou modifier des balises (AWS CLI)

Les exemples suivants montrent comment utiliser le AWS CLI pour ajouter des balises lorsque vous créez des groupes Auto Scaling et pour ajouter ou modifier des balises pour des groupes Auto Scaling existants.

Pour étiqueter un groupe Auto Scaling lors de la création

Utilisez la create-auto-scaling-groupcommande pour créer un nouveau groupe Auto Scaling et ajouter une balise, par exempleenvironment=production, au groupe Auto Scaling. La balise est également ajoutée aux instances lancées dans le groupe Auto Scaling.

aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-configuration-name my-launch-config --min-size 1 --max-size 3 \
  --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
  --tags Key=environment,Value=production,PropagateAtLaunch=true

Pour créer ou modifier des balises pour un groupe Auto Scaling existant

Utilisez la create-or-update-tagscommande pour créer ou modifier un tag. Par exemple, la commande suivante ajoute les balises Name=my-asg et costcenter=cc123. Les balises sont également ajoutées aux instances lancées dans le groupe Auto Scaling après cette modification. Si une balise avec cette clé existe déjà, la balise existante est remplacée. La console Amazon EC2 associe le nom d'affichage de chaque instance avec le nom spécifié pour la clé Name (sensible à la casse).

aws autoscaling create-or-update-tags \
  --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Name,Value=my-asg,PropagateAtLaunch=true \
  ResourceId=my-asg,ResourceType=auto-scaling-group,Key=costcenter,Value=cc123,PropagateAtLaunch=true

Décrire les balises d'un groupe Auto Scaling (AWS CLI)

Si vous souhaitez afficher les balises qui sont appliquées à un groupe Auto Scaling spécifique, vous pouvez utiliser l'une des commandes suivantes :

Supprimer des balises

Vous pouvez supprimer une balise associée au groupe Auto Scaling à tout moment.

Supprimer des balises (console)

Supprimer des balises (AWS CLI)

Utilisez la commande delete-tags pour supprimer une balise. Par exemple, la commande suivante supprime une balise avec une clé environment.

aws autoscaling delete-tags --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=environment"

Vous devez préciser la clé de balise, mais pas la valeur. Si vous spécifiez une valeur et qu'elle est incorrecte, la balise n'est pas supprimée.

Balises pour la sécurité

Utilisez des balises pour vérifier que le demandeur (tel qu'un utilisateur ou un rôle IAM) dispose des autorisations de créer, modifier ou supprimer des groupes Auto Scaling spécifiques. Fournissez des informations de balise dans l'élément de condition d'une politique IAM à l'aide des clés de condition suivantes :

Par exemple, vous pouvez refuser l'accès à tous les groupes Auto Scaling qui incluent une balise avec la clé environment et la valeur production, comme illustré dans l'exemple suivant.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [        
                "autoscaling:CreateAutoScalingGroup",
                "autoscaling:UpdateAutoScalingGroup",
                "autoscaling:DeleteAutoScalingGroup"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {"autoscaling:ResourceTag/environment": "production"}
            }
        }
    ]
}

Pour plus d’informations sur l’utilisation des clés de condition afin de contrôler l’accès aux groupes Auto Scaling, consultez Fonctionnement d'Amazon EC2 Auto Scaling avec IAM.

Contrôler l'accès aux balises

Utilisez des balises pour vérifier que le demandeur (tel qu'un utilisateur ou un rôle IAM) dispose des autorisations d'ajouter, modifier ou supprimer des balises pour des groupes Auto Scaling.

L’exemple de politique IAM suivant donne l’autorisation principale de supprimer uniquement la balise avec la clé temporary des groupes Auto Scaling.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "autoscaling:DeleteTags",
            "Resource": "*",
            "Condition": {
                "ForAllValues:StringEquals": { "aws:TagKeys": ["temporary"] }
            }
        }
    ]
}

Pour plus d’exemples de politiques IAM qui appliquent des contraintes sur les balises spécifiées pour les groupes Auto Scaling, consultez Contrôler les clés de balise et les valeurs de balise pouvant être utilisées.

Utilisation d'identifications pour filtrer les groupes Auto Scaling

Les exemples suivants vous montrent comment utiliser des filtres avec la describe-auto-scaling-groupscommande pour décrire les groupes Auto Scaling dotés de balises spécifiques. Le filtrage par balises est limité au SDK AWS CLI ou à un SDK et n'est pas disponible depuis la console.

Considérations relatives au filtrage

Exemple : décrire les groupes Auto Scaling avec une paire clé-valeur d'identification spécifique

La commande suivante montre comment filtrer les résultats pour n'afficher que les groupes Auto Scaling dont la paire clé/valeur d'identification est environment=production.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment Name=tag-value,Values=production

Voici un exemple de réponse.

{
    "AutoScalingGroups": [
        {
            "AutoScalingGroupName": "my-asg",
            "AutoScalingGroupARN": "arn",
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-0b97f1e282EXAMPLE",
                "LaunchTemplateName": "my-launch-template",
                "Version": "$Latest"
            },
            "MinSize": 1,
            "MaxSize": 5,
            "DesiredCapacity": 1,
            ...
            "Tags": [
                {
                    "ResourceType": "auto-scaling-group",
                    "ResourceId": "my-asg",
                    "PropagateAtLaunch": true,
                    "Value": "production",
                    "Key": "environment"
                }
            ],
            ...
        },

    ... additional groups ...

    ]
}

Vous pouvez également spécifier des identifiants à l'aide d'un filtre tag:<key>. Par exemple, la commande suivante montre comment filtrer les résultats pour n'afficher que les groupes Auto Scaling avec une paire clé et valeur d'identification de environment=production. Ce filtre est formaté comme suit : Name=tag:<key>,Values=<value>, avec <key> et <value> représentant une paire clé et valeur d'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production

Vous pouvez également filtrer la AWS CLI sortie à l'aide de l'--queryoption. L'exemple suivant montre comment limiter la AWS CLI sortie de la commande précédente au nom du groupe, à la taille minimale, à la taille maximale et aux attributs de capacité souhaités uniquement.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production \
  --query "AutoScalingGroups[].{AutoScalingGroupName: AutoScalingGroupName, MinSize: MinSize, MaxSize: MaxSize, DesiredCapacity: DesiredCapacity}"

Voici un exemple de réponse.

[
    {
        "AutoScalingGroupName": "my-asg",
        "MinSize": 0,
        "MaxSize": 10,
        "DesiredCapacity": 1
    },

    ... additional groups ...

]

Pour plus d'informations sur le filtrage, consultez la section Filtrage AWS CLI de la sortie dans le guide de AWS Command Line Interface l'utilisateur.

Exemple : décrire les groupes Auto Scaling dont les identifications correspondent à la clé d'identification spécifiée

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling avec l'identification environment, quelle que soit la valeur de l'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment

Exemple : décrire les groupes d'Auto Scaling dont les identifications correspondent à l'ensemble des clés d'identification spécifiées

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling avec des identifications pour environment et project, quelle que soit la valeur de l'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment Name=tag-key,Values=project

Exemple : décrire les groupes Auto Scaling dont les identifications correspondent à au moins une des clés d'identification spécifiées

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling avec des identifications pour environment ou project, quelle que soit la valeur de l'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment,project

Exemple : décrire les groupes Auto Scaling avec la valeur d'identification spécifiée

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling dont la valeur de l'identification est production, quelle que soit la clé de l'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production

Exemple : décrire les groupes Auto Scaling avec l'ensemble des valeurs d'identification spécifiées

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling dont l'identification est production et development, quelle que soit la clé d'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production Name=tag-value,Values=development

Exemple : décrire les groupes Auto Scaling dont les identifications correspondent à au moins une des valeurs d'identification spécifiées

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling dont la valeur de l'identification est production ou development, quelle que soit la clé de l'identification.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production,development

Exemple : décrire les groupes d'Auto Scaling dont les identifications correspondent à plusieurs clés et valeurs d'identification

Vous pouvez également combiner des filtres pour créer une logique AND et OR personnalisée pour effectuer un filtrage plus complexe.

La commande suivante montre comment filtrer les résultats pour afficher uniquement les groupes Auto Scaling avec un ensemble spécifique d'identifications. Une clé d'identification est environment AND la valeur de l'identification est (production OR development) AND l'autre clé d'identification est costcenter AND la valeur de l'identification est cc123.

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production,development Name=tag:costcenter,Values=cc123