Exemples d'Auto Scaling utilisant AWS CLI

Pour attacher une instance à un groupe Auto Scaling

Cet exemple attache l’instance spécifiée au groupe Auto Scaling spécifié.

aws autoscaling attach-instances \
    --instance-ids i-061c63c5eb45f0416 \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour attacher un groupe cible à un groupe Auto Scaling

Cet exemple attache le groupe cible spécifié au groupe Auto Scaling spécifié.

aws autoscaling attach-load-balancer-target-groups \
    --auto-scaling-group-name my-asg \
    --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Elastic Load Balancing et Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour attacher un Classic Load Balancer à un groupe Auto Scaling

Cet exemple attache le Classic Load Balancer spécifié au groupe Auto Scaling spécifié.

aws autoscaling attach-load-balancers \
    --load-balancer-names my-load-balancer \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Elastic Load Balancing et Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour annuler une actualisation d’instance

L’exemple cancel-instance-refresh suivant annule une actualisation d’instance en cours pour le groupe Auto Scaling spécifié.

aws autoscaling cancel-instance-refresh \
    --auto-scaling-group-name my-asg

Sortie :

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

Pour plus d'informations, consultez Annuler l'actualisation d'une instance dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Pour terminer une action de cycle de vie

Cet exemple indique à Amazon EC2 Auto Scaling que l'action du cycle de vie spécifiée est terminée afin qu'il puisse terminer le lancement ou la fin de l'instance.

aws autoscaling complete-lifecycle-action \
    --lifecycle-hook-name my-launch-hook \
    --auto-scaling-group-name my-asg \
    --lifecycle-action-result CONTINUE \
    --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour créer un groupe Auto Scaling

L’exemple create-auto-scaling-group suivant crée un groupe Auto Scaling dans des sous-réseaux de plusieurs zones de disponibilité au sein d’une région. Les instances sont lancées avec la version par défaut du modèle de lancement spécifié. Notez que les valeurs par défaut sont utilisées pour la plupart des autres paramètres, tels que les politiques de résiliation et la configuration de la surveillance de l’état.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12 \
    --min-size 1 \
    --max-size 5 \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Groupes Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour attacher un Application Load Balancer, un Network Load Balancer ou un Gateway Load Balancer

Cet exemple indique l’ARN d’un groupe cible pour un équilibreur de charge qui prend en charge le trafic attendu. Le type de surveillance de l’état indique ELB, de sorte que lorsqu’Elastic Load Balancing signale qu’une instance est défectueuse, le groupe Auto Scaling la remplace. La commande définit également une période de grâce de surveillance de l’état de 600 secondes. La période de grâce permet d’éviter la résiliation prématurée des instances nouvellement lancées.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12 \
    --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/943f017f100becff \
    --health-check-type ELB \
    --health-check-grace-period 600 \
    --min-size 1 \
    --max-size 5 \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Elastic Load Balancing et Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour spécifier un groupe de placement et utiliser la dernière version du modèle de lancement

Cet exemple lance des instances dans un groupe de placement dans une même zone de disponibilité. Cela peut être utile pour les groupes à faible latence soumis à des charges de travail HPC. Cet exemple indique également la taille minimale, la taille maximale et la capacité souhaitée du groupe.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest' \
    --min-size 1 \
    --max-size 5 \
    --desired-capacity 3 \
    --placement-group my-placement-group \
    --vpc-zone-identifier "subnet-6194ea3b"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Groupes de placement dans le Guide de EC2 l'utilisateur Amazon pour les instances Linux.

Exemple 4 : pour spécifier un groupe Auto Scaling à instance unique et utiliser une version spécifique du modèle de lancement

Cet exemple crée un groupe Auto Scaling dont les capacités minimale et maximale sont définies sur 1 de manière à garantir l’exécution d’une instance. La commande spécifie également la v1 d’un modèle de lancement dans lequel l’ID d’une ENI existante est spécifié. Lorsque vous utilisez un modèle de lancement qui spécifie une ENI existante pour eth0, vous devez spécifier une zone de disponibilité pour le groupe Auto Scaling qui correspond à l’interface réseau, sans également spécifier d’ID de sous-réseau dans la demande.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg-single-instance \
    --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='1' \
    --min-size 1 \
    --max-size 1 \
    --availability-zones us-west-2a

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Groupes Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 5 : pour spécifier une politique de résiliation différente

Cet exemple crée un groupe Auto Scaling à l’aide d’une configuration de lancement et définit la politique de résiliation pour résilier les instances les plus anciennes en premier. La commande applique également une balise au groupe et à ses instances, avec une clé Role et une valeur de WebServer.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-configuration-name my-lc \
    --min-size 1 \
    --max-size 5 \
    --termination-policies "OldestInstance" \
    --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true" \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Working with Amazon EC2 Auto Scaling résiliation policies dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 6 : pour spécifier un hook de cycle de vie de lancement

Cet exemple crée un groupe Auto Scaling avec un hook de cycle de vie qui prend en charge une action personnalisée lors du lancement de l’instance.

aws autoscaling create-auto-scaling-group \
    --cli-input-json file://~/config.json

Contenu du fichier config.json :

{
    "AutoScalingGroupName": "my-asg",
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-1234567890abcde12"
    },
    "LifecycleHookSpecificationList": [{
        "LifecycleHookName": "my-launch-hook",
        "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
        "NotificationTargetARN": "arn:aws:sqs:us-west-2:123456789012:my-sqs-queue",
        "RoleARN": "arn:aws:iam::123456789012:role/my-notification-role",
        "NotificationMetadata": "SQS message metadata",
        "HeartbeatTimeout": 4800,
        "DefaultResult": "ABANDON"
    }],
    "MinSize": 1,
    "MaxSize": 5,
    "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
    "Tags": [{
        "ResourceType": "auto-scaling-group",
        "ResourceId": "my-asg",
        "PropagateAtLaunch": true,
        "Value": "test",
        "Key": "environment"
    }]
}

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 7 : pour spécifier un hook de cycle de vie de résiliation

Cet exemple crée un groupe Auto Scaling avec un hook de cycle de vie qui prend en charge une action personnalisée lors de la résiliation de l’instance.

aws autoscaling create-auto-scaling-group \
    --cli-input-json file://~/config.json

Contenu de config.json :

{
    "AutoScalingGroupName": "my-asg",
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-1234567890abcde12"
    },
    "LifecycleHookSpecificationList": [{
        "LifecycleHookName": "my-termination-hook",
        "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
        "HeartbeatTimeout": 120,
        "DefaultResult": "CONTINUE"
    }],
    "MinSize": 1,
    "MaxSize": 5,
    "TargetGroupARNs": [
        "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
    ],
    "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"
}

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 8 : pour spécifier une politique de résiliation personnalisée

Cet exemple crée un groupe Auto Scaling qui spécifie une politique d'arrêt de fonction Lambda personnalisée qui indique à Amazon EC2 Auto Scaling quelles instances peuvent être interrompues en toute sécurité à grande échelle.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg-single-instance \
    --launch-template LaunchTemplateName=my-template-for-auto-scaling \
    --min-size 1 \
    --max-size 5 \
    --termination-policies "arn:aws:lambda:us-west-2:123456789012:function:HelloFunction:prod" \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Création d'une politique de résiliation personnalisée avec Lambda dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 1 : pour créer une configuration de lancement

Cet exemple crée une configuration de lancement simple.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Création d'une configuration de lancement dans le manuel Amazon EC2 Auto Scaling User Guide.

Exemple 2 : pour créer une configuration de lancement avec un groupe de sécurité, une paire de clés et un script de démarrage

Cet exemple crée une configuration de lancement avec un groupe de sécurité, une paire de clés et un script de démarrage contenus dans les données utilisateur.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --security-groups sg-eb2af88example \
    --key-name my-key-pair \
    --user-data file://myuserdata.txt

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Création d'une configuration de lancement dans le manuel Amazon EC2 Auto Scaling User Guide.

Exemple 3 : pour créer une configuration de lancement avec un rôle IAM

Cet exemple crée une configuration de lancement avec le nom de profil d’instance d’un rôle IAM.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --iam-instance-profile my-autoscaling-role

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez le rôle IAM pour les applications qui s'exécutent sur des EC2 instances Amazon dans le manuel Amazon EC2 Auto Scaling User Guide.

Exemple 4 : pour créer une configuration de lancement avec la surveillance détaillée activée

Cet exemple crée une configuration de lancement avec la surveillance EC2 détaillée activée, qui envoie EC2 des métriques par CloudWatch intervalles d'une minute.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --instance-monitoring Enabled=true

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Configuration de la surveillance pour les instances Auto Scaling dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 5 : pour créer une configuration de lancement qui lance des instances Spot

Cet exemple crée une configuration de lancement qui utilise les instances Spot comme seule option d’achat.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --spot-price "0.50"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Request Spot Instances dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 6 : pour créer une configuration de lancement à l'aide d'une EC2 instance

Cet exemple crée une configuration de lancement basée sur les attributs d’une instance existante. Il remplace la location de placement et indique si une adresse IP publique est définie en incluant les options --placement-tenancy et --no-associate-public-ip-address.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc-from-instance \
    --instance-id i-0123a456700123456 \
    --instance-type m5.large \
    --no-associate-public-ip-address \
    --placement-tenancy dedicated

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Création d'une configuration de lancement à l'aide d'une EC2 instance dans le manuel Amazon EC2 Auto Scaling User Guide.

Exemple 7 : pour créer une configuration de lancement avec un mappage de périphérique de stockage en mode bloc pour un volume Amazon EBS

Cet exemple crée une configuration de lancement avec un mappage de périphérique de stockage en mode bloc pour un volume gp3 d’Amazon EBS avec le nom d’appareil /dev/sdh et une taille de volume de 20.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdh","Ebs":{"VolumeSize":20,"VolumeType":"gp3"}}]'

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez EBS dans le manuel Amazon EC2 Auto Scaling API Reference.

Pour plus d'informations sur la syntaxe permettant de citer des valeurs de paramètres au format JSON, consultez la section Utilisation de guillemets avec des chaînes dans la AWS CLI du Guide de l'utilisateur de l'interface de ligne de AWS commande.

Exemple 8 : pour créer une configuration de lancement avec un mappage de périphérique de stockage en mode bloc pour un volume de stockage d’instances

Cet exemple crée une configuration de lancement avec ephemeral1 comme volume de stockage d’instances avec le nom d’appareil /dev/sdc.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdc","VirtualName":"ephemeral1"}]'

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez BlockDeviceMappingle manuel Amazon EC2 Auto Scaling API Reference.

Pour plus d'informations sur la syntaxe permettant de citer des valeurs de paramètres au format JSON, consultez la section Utilisation de guillemets avec des chaînes dans la AWS CLI du Guide de l'utilisateur de l'interface de ligne de AWS commande.

Exemple 9 : pour créer une configuration de lancement et empêcher un périphérique de stockage en mode bloc de s’attacher au moment du lancement

Cet exemple crée une configuration de lancement qui supprime un périphérique de stockage en mode bloc spécifié par le mappage de périphérique de stockage en mode bloc de l’AMI (par exemple, /dev/sdf).

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdf","NoDevice":""}]'

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez BlockDeviceMappingle manuel Amazon EC2 Auto Scaling API Reference.

Pour plus d'informations sur la syntaxe permettant de citer des valeurs de paramètres au format JSON, consultez la section Utilisation de guillemets avec des chaînes dans la AWS CLI du Guide de l'utilisateur de l'interface de ligne de AWS commande.

Pour créer ou mettre à jour des balises pour un groupe Auto Scaling

Cet exemple ajoute deux balises au groupe Auto Scaling spécifié.

aws autoscaling create-or-update-tags \
    --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Dept,Value=Research,PropagateAtLaunch=true

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Tagging Auto Scaling groups and instances dans le Amazon EC2 Auto Scaling User Guide.

Exemple 1 : pour supprimer le groupe Auto Scaling spécifié

Cet exemple supprime le groupe Auto Scaling spécifié.

aws autoscaling delete-auto-scaling-group \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Supprimer votre infrastructure Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour forcer la suppression du groupe Auto Scaling spécifié

Pour supprimer le groupe Auto Scaling sans attendre que les instances du groupe se résilient, utilisez l’option --force-delete.

aws autoscaling delete-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --force-delete

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Supprimer votre infrastructure Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour supprimer une configuration de lancement

Cet exemple supprime la configuration de lancement spécifiée.

aws autoscaling delete-launch-configuration \
    --launch-configuration-name my-launch-config

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Supprimer votre infrastructure Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour supprimer un hook de cycle de vie

Cet exemple supprime le hook de cycle de vie spécifié.

aws autoscaling delete-lifecycle-hook \
    --lifecycle-hook-name my-lifecycle-hook \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour supprimer une notification Auto Scaling

Cet exemple supprime la notification spécifiée du groupe Auto Scaling spécifié.

aws autoscaling delete-notification-configuration \
    --auto-scaling-group-name my-asg \
    --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Supprimer la configuration des notifications dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Pour supprimer une stratégie de mise à l’échelle

Cet exemple supprime la stratégie de mise à l’échelle spécifiée.

aws autoscaling delete-policy \
    --auto-scaling-group-name my-asg \
    --policy-name alb1000-target-tracking-scaling-policy

Cette commande ne produit aucune sortie.

Pour supprimer une action planifiée d’un groupe Auto Scaling

Cet exemple supprime l’action planifiée spécifiée du groupe Auto Scaling spécifié.

aws autoscaling delete-scheduled-action \
    --auto-scaling-group-name my-asg \
    --scheduled-action-name my-scheduled-action

Cette commande ne produit aucune sortie.

Pour supprimer une balise d’un groupe Auto Scaling

Cet exemple supprime la balise spécifiée du groupe Auto Scaling spécifié.

aws autoscaling delete-tags \
    --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Dept,Value=Research

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Tagging Auto Scaling groups and instances dans le Amazon EC2 Auto Scaling User Guide.

Exemple 1 : pour supprimer un groupe d’instances pré-initialisées

L’exemple suivant supprime le groupe d’instances pré-initialisées pour le groupe Auto Scaling spécifié.

aws autoscaling delete-warm-pool \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Warm pools for Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour forcer la suppression d’un groupe d’instances pré-initialisées

Pour supprimer le groupe d’instances pré-initialisées sans attendre que ses instances se résilient, utilisez l’option --force-delete.

aws autoscaling delete-warm-pool \
    --auto-scaling-group-name my-asg \
    --force-delete

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Warm pools for Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour décrire les limites de votre compte Amazon EC2 Auto Scaling

Cet exemple décrit les limites d'Amazon EC2 Auto Scaling pour votre AWS compte.

aws autoscaling describe-account-limits

Sortie :

{
    "NumberOfLaunchConfigurations": 5,
    "MaxNumberOfLaunchConfigurations": 100,
    "NumberOfAutoScalingGroups": 3,
    "MaxNumberOfAutoScalingGroups": 20
}

Pour plus d'informations, consultez les quotas du service Amazon EC2 Auto Scaling dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Pour décrire les types d’ajustements de la mise à l’échelle disponibles

Cet exemple décrit les types d’ajustements disponibles.

aws autoscaling describe-adjustment-types

Sortie :

{
    "AdjustmentTypes": [
        {
            "AdjustmentType": "ChangeInCapacity"
        },
        {
            "AdjustmentType": "ExactCapacity"
        },
        {
            "AdjustmentType": "PercentChangeInCapacity"
        }
    ]
}

Pour plus d'informations, consultez la section Types d'ajustement de dimensionnement dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire le groupe Auto Scaling spécifié

Cet exemple décrit le groupe Auto Scaling spécifié.

aws autoscaling describe-auto-scaling-groups \
    --auto-scaling-group-names my-asg

Sortie :

{
    "AutoScalingGroups": [
        {
            "AutoScalingGroupName": "my-asg",
            "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg",
            "LaunchTemplate": {
                "LaunchTemplateName": "my-launch-template",
                "Version": "1",
                "LaunchTemplateId": "lt-1234567890abcde12"
            },
            "MinSize": 0,
            "MaxSize": 1,
            "DesiredCapacity": 1,
            "DefaultCooldown": 300,
            "AvailabilityZones": [
                "us-west-2a",
                "us-west-2b",
                "us-west-2c"
            ],
            "LoadBalancerNames": [],
            "TargetGroupARNs": [],
            "HealthCheckType": "EC2",
            "HealthCheckGracePeriod": 0,
            "Instances": [
                {
                    "InstanceId": "i-06905f55584de02da",
                    "InstanceType": "t2.micro",
                    "AvailabilityZone": "us-west-2a",
                    "HealthStatus": "Healthy",
                    "LifecycleState": "InService",
                    "ProtectedFromScaleIn": false,
                    "LaunchTemplate": {
                        "LaunchTemplateName": "my-launch-template",
                        "Version": "1",
                        "LaunchTemplateId": "lt-1234567890abcde12"
                    }
                }
            ],
            "CreatedTime": "2023-10-28T02:39:22.152Z",
            "SuspendedProcesses": [],
            "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
            "EnabledMetrics": [],
            "Tags": [],
            "TerminationPolicies": [
                "Default"
            ],
            "NewInstancesProtectedFromScaleIn": false,
            "ServiceLinkedRoleARN":"arn",
            "TrafficSources": []
        }
    ]
}

Exemple 2 : pour décrire les 100 premiers groupes Auto Scaling spécifiés

Cet exemple décrit les groupes Auto Scaling spécifiés. Il vous permet de spécifier jusqu’à 100 noms de groupe.

aws autoscaling describe-auto-scaling-groups \
    --max-items 100 \
    --auto-scaling-group-names "group1" "group2" "group3" "group4"

Consultez l’exemple 1 pour un exemple de sortie.

Exemple 3 : pour décrire un groupe Auto Scaling dans la région spécifiée

Cet exemple décrit les groupes Auto Scaling dans la région spécifiée, jusqu’à 75 groupes maximum.

aws autoscaling describe-auto-scaling-groups \
    --max-items 75 \
    --region us-east-1

Consultez l’exemple 1 pour un exemple de sortie.

Exemple 4 : pour décrire le nombre spécifié de groupes Auto Scaling

Pour renvoyer un nombre spécifique de groupes Auto Scaling, utilisez l’option --max-items.

aws autoscaling describe-auto-scaling-groups \
    --max-items 1

Consultez l’exemple 1 pour un exemple de sortie.

Si la sortie inclut un champ NextToken, il existe d’autres groupes. Pour obtenir les groupes supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur comme suit.

aws autoscaling describe-auto-scaling-groups \
    --starting-token Z3M3LMPEXAMPLE

Consultez l’exemple 1 pour un exemple de sortie.

Exemple 5 : pour décrire les groupes Auto Scaling qui utilisent des configurations de lancement

Cet exemple utilise l’option --query pour décrire les groupes Auto Scaling qui utilisent des configurations de lancement.

aws autoscaling describe-auto-scaling-groups \
    --query 'AutoScalingGroups[?LaunchConfigurationName!=`null`]'

Sortie :

[
    {
        "AutoScalingGroupName": "my-asg",
        "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg",
        "LaunchConfigurationName": "my-lc",
        "MinSize": 0,
        "MaxSize": 1,
        "DesiredCapacity": 1,
        "DefaultCooldown": 300,
        "AvailabilityZones": [
            "us-west-2a",
            "us-west-2b",
            "us-west-2c"
        ],
        "LoadBalancerNames": [],
        "TargetGroupARNs": [],
        "HealthCheckType": "EC2",
        "HealthCheckGracePeriod": 0,
        "Instances": [
            {
                "InstanceId": "i-088c57934a6449037",
                "InstanceType": "t2.micro",
                "AvailabilityZone": "us-west-2c",
                "HealthStatus": "Healthy",
                "LifecycleState": "InService",
                "LaunchConfigurationName": "my-lc",
                "ProtectedFromScaleIn": false
            }
        ],
        "CreatedTime": "2023-10-28T02:39:22.152Z",
        "SuspendedProcesses": [],
        "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
        "EnabledMetrics": [],
        "Tags": [],
        "TerminationPolicies": [
            "Default"
        ],
        "NewInstancesProtectedFromScaleIn": false,
        "ServiceLinkedRoleARN":"arn",
        "TrafficSources": []
    }
]

Pour plus d'informations, consultez la section Filtrer la sortie de la AWS CLI dans le guide de l'utilisateur de l'interface de ligne de AWS commande.

Exemple 1 : pour décrire une ou plusieurs instances

Cet exemple décrit l’instance spécifiée.

aws autoscaling describe-auto-scaling-instances \
    --instance-ids i-06905f55584de02da

Sortie :

{
    "AutoScalingInstances": [
        {
            "InstanceId": "i-06905f55584de02da",
            "InstanceType": "t2.micro",
            "AutoScalingGroupName": "my-asg",
            "AvailabilityZone": "us-west-2b",
            "LifecycleState": "InService",
            "HealthStatus": "HEALTHY",
            "ProtectedFromScaleIn": false,
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-1234567890abcde12",
                "LaunchTemplateName": "my-launch-template",
                "Version": "1"
            }
        }
    ]
}

Exemple 2 : pour décrire une ou plusieurs instances

Cet exemple utilise l’option --max-items pour spécifier le nombre d’instances à renvoyer avec cet appel.

aws autoscaling describe-auto-scaling-instances \
    --max-items 1

Si la sortie inclut un champ NextToken, il existe d’autres instances. Pour obtenir les instances supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur comme suit.

aws autoscaling describe-auto-scaling-instances \
    --starting-token Z3M3LMPEXAMPLE

Consultez l’exemple 1 pour un exemple de sortie.

Exemple 3 : pour décrire les instances qui utilisent des configurations de lancement

Cet exemple utilise l’option --query pour décrire les instances qui utilisent des configurations de lancement.

aws autoscaling describe-auto-scaling-instances \
    --query 'AutoScalingInstances[?LaunchConfigurationName!=`null`]'

Sortie :

[
    {
        "InstanceId": "i-088c57934a6449037",
        "InstanceType": "t2.micro",
        "AutoScalingGroupName": "my-asg",
        "AvailabilityZone": "us-west-2c",
        "LifecycleState": "InService",
        "HealthStatus": "HEALTHY",
        "LaunchConfigurationName": "my-lc",
        "ProtectedFromScaleIn": false
    }
]

Pour plus d'informations, consultez la section Filtrer la sortie de la AWS CLI dans le guide de l'utilisateur de l'interface de ligne de AWS commande.

Pour décrire les types de notifications disponibles

Cet exemple décrit les types de notifications disponibles.

aws autoscaling describe-auto-scaling-notification-types

Sortie :

{
    "AutoScalingNotificationTypes": [
        "autoscaling:EC2_INSTANCE_LAUNCH",
        "autoscaling:EC2_INSTANCE_LAUNCH_ERROR",
        "autoscaling:EC2_INSTANCE_TERMINATE",
        "autoscaling:EC2_INSTANCE_TERMINATE_ERROR",
        "autoscaling:TEST_NOTIFICATION"
    ]
}

Pour plus d'informations, consultez la section Recevoir des notifications Amazon SNS lorsque votre groupe Auto Scaling évolue dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour décrire des actualisations d’instance

L’exemple describe-instance-refreshes suivant renvoie une description de toutes les demandes d’actualisation d’instance pour le groupe Auto Scaling spécifié, y compris le message de statut et (si disponible) la raison du statut.

aws autoscaling describe-instance-refreshes \
    --auto-scaling-group-name my-asg

Sortie :

{
    "InstanceRefreshes": [
        {
            "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b",
            "AutoScalingGroupName": "my-asg",
            "Status": "InProgress",
            "StatusReason": "Waiting for instances to warm up before continuing. For example: 0e69cc3f05f825f4f is warming up.",
            "EndTime": "2023-03-23T16:42:55Z",
            "PercentageComplete": 0,
            "InstancesToUpdate": 0,
    "Preferences": {
                "MinHealthyPercentage": 100,
                "InstanceWarmup": 300,
                "CheckpointPercentages": [
                    50
                ],
                "CheckpointDelay": 3600,
                "SkipMatching": false,
                "AutoRollback": true,
                "ScaleInProtectedInstances": "Ignore",
                "StandbyInstances": "Ignore"
            }
        },
        {
            "InstanceRefreshId": "dd7728d0-5bc4-4575-96a3-1b2c52bf8bb1",
            "AutoScalingGroupName": "my-asg",
            "Status": "Successful",
            "EndTime": "2022-06-02T16:53:37Z",
            "PercentageComplete": 100,
            "InstancesToUpdate": 0,
    "Preferences": {
                "MinHealthyPercentage": 90,
                "InstanceWarmup": 300,
                "SkipMatching": true,
                "AutoRollback": true,
                "ScaleInProtectedInstances": "Ignore",
                "StandbyInstances": "Ignore"
            }
        }
    ]
}

Pour plus d'informations, consultez Vérifier l'état de l'actualisation d'une instance dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire la configuration de lancement spécifiée

Cet exemple décrit la configuration de lancement spécifiée.

aws autoscaling describe-launch-configurations \
    --launch-configuration-names my-launch-config

Sortie :

{
    "LaunchConfigurations": [
        {
            "LaunchConfigurationName": "my-launch-config",
            "LaunchConfigurationARN": "arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:98d3b196-4cf9-4e88-8ca1-8547c24ced8b:launchConfigurationName/my-launch-config",
            "ImageId": "ami-0528a5175983e7f28",
            "KeyName": "my-key-pair-uswest2",
            "SecurityGroups": [
                "sg-05eaec502fcdadc2e"
            ],
            "ClassicLinkVPCSecurityGroups": [],
            "UserData": "",
            "InstanceType": "t2.micro",
            "KernelId": "",
            "RamdiskId": "",
            "BlockDeviceMappings": [
                {
                    "DeviceName": "/dev/xvda",
                    "Ebs": {
                        "SnapshotId": "snap-06c1606ba5ca274b1",
                        "VolumeSize": 8,
                        "VolumeType": "gp2",
                        "DeleteOnTermination": true,
                        "Encrypted": false
                    }
                }
            ],
            "InstanceMonitoring": {
                "Enabled": true
            },
            "CreatedTime": "2020-10-28T02:39:22.321Z",
            "EbsOptimized": false,
            "AssociatePublicIpAddress": true,
            "MetadataOptions": {
                "HttpTokens": "required",
                "HttpPutResponseHopLimit": 1,
                "HttpEndpoint": "disabled"
            }
        }
    ]
}

Exemple 2 : pour décrire un nombre spécifié de configurations de lancement

Pour renvoyer un nombre spécifique de configurations de lancement, utilisez l’option --max-items.

aws autoscaling describe-launch-configurations \
    --max-items 1

Si la sortie inclut un champ NextToken, il existe d’autres configurations de lancement. Pour obtenir les configurations de lancement supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur comme suit.

aws autoscaling describe-launch-configurations \
    --starting-token Z3M3LMPEXAMPLE

Pour décrire les types de hooks de cycle de vie disponibles

Cet exemple décrit les types de hooks de cycle de vie disponibles.

aws autoscaling describe-lifecycle-hook-types

Sortie :

{
    "LifecycleHookTypes": [
        "autoscaling:EC2_INSTANCE_LAUNCHING",
        "autoscaling:EC2_INSTANCE_TERMINATING"
    ]
}

Pour décrire vos hooks de cycle de vie

Cet exemple décrit les hooks de cycle de vie pour le groupe Auto Scaling spécifié.

aws autoscaling describe-lifecycle-hooks \
    --auto-scaling-group-name my-asg

Sortie :

{
    "LifecycleHooks": [
        {
            "GlobalTimeout": 3000,
            "HeartbeatTimeout": 30,
            "AutoScalingGroupName": "my-asg",
            "LifecycleHookName": "my-launch-hook",
            "DefaultResult": "ABANDON",
            "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING"
        },
        {
            "GlobalTimeout": 6000,
            "HeartbeatTimeout": 60,
            "AutoScalingGroupName": "my-asg",
            "LifecycleHookName": "my-termination-hook",
            "DefaultResult": "CONTINUE",
            "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING"
        }
    ]
}

Pour décrire les groupes cibles de l’équilibreur de charge pour un groupe Auto Scaling

Cet exemple décrit les groupes cibles de l’équilibreur de charge attachés au groupe Auto Scaling spécifié.

aws autoscaling describe-load-balancer-target-groups \
    --auto-scaling-group-name my-asg

Sortie :

{
    "LoadBalancerTargetGroups": [
        {
            "LoadBalancerTargetGroupARN": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
            "State": "Added"
        }
    ]
}

Pour décrire les Classic Load Balancers pour un groupe Auto Scaling

Cet exemple décrit les Classic Load Balancers pour le groupe Auto Scaling spécifié.

aws autoscaling describe-load-balancers \
    --auto-scaling-group-name my-asg

Sortie :

{
    "LoadBalancers": [
        {
            "State": "Added",
            "LoadBalancerName": "my-load-balancer"
        }
    ]
}

Pour décrire les types de collectes de métriques disponibles

Cet exemple décrit les types de collectes de métriques disponibles.

aws autoscaling describe-metric-collection-types

Sortie :

{
    "Metrics": [
        {
            "Metric": "GroupMinSize"
        },
        {
            "Metric": "GroupMaxSize"
        },
        {
            "Metric": "GroupDesiredCapacity"
        },
        {
            "Metric": "GroupInServiceInstances"
        },
        {
            "Metric": "GroupInServiceCapacity"
        },
        {
            "Metric": "GroupPendingInstances"
        },
        {
            "Metric": "GroupPendingCapacity"
        },
        {
            "Metric": "GroupTerminatingInstances"
        },
        {
            "Metric": "GroupTerminatingCapacity"
        },
        {
            "Metric": "GroupStandbyInstances"
        },
        {
            "Metric": "GroupStandbyCapacity"
        },
        {
            "Metric": "GroupTotalInstances"
        },
        {
            "Metric": "GroupTotalCapacity"
        }
    ],
    "Granularities": [
        {
            "Granularity": "1Minute"
        }
    ]
}

Pour plus d'informations, consultez les métriques de groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire les configurations de notification d’un groupe spécifié

Cet exemple décrit les configurations de notification pour le groupe Auto Scaling spécifié.

aws autoscaling describe-notification-configurations \
    --auto-scaling-group-name my-asg

Sortie :

{
    "NotificationConfigurations": [
        {
            "AutoScalingGroupName": "my-asg",
            "NotificationType": "autoscaling:TEST_NOTIFICATION",
            "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2"
        },
        {
            "AutoScalingGroupName": "my-asg",
            "NotificationType": "autoscaling:TEST_NOTIFICATION",
            "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic"
        }
    ]
}

Pour plus d'informations, consultez la section Recevoir des notifications Amazon SNS lorsque votre groupe Auto Scaling évolue dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire un nombre spécifié de configurations de notification

Pour renvoyer un nombre spécifique de configurations de notification, utilisez le paramètre max-items.

aws autoscaling describe-notification-configurations \
    --auto-scaling-group-name my-auto-scaling-group \
    --max-items 1

Sortie :

{
    "NotificationConfigurations": [
        {
            "AutoScalingGroupName": "my-asg",
            "NotificationType": "autoscaling:TEST_NOTIFICATION",
            "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2"
        },
        {
            "AutoScalingGroupName": "my-asg",
            "NotificationType": "autoscaling:TEST_NOTIFICATION",
            "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic"
        }
    ]
}

Si la sortie inclut un champ NextToken, il existe d’autres configurations de notification. Pour obtenir les configurations de notification supplémentaires, utilisez la valeur de ce champ avec le paramètre starting-token lors d’un appel ultérieur comme suit.

aws autoscaling describe-notification-configurations \
    --auto-scaling-group-name my-asg \
    --starting-token Z3M3LMPEXAMPLE

Pour plus d'informations, consultez la section Recevoir des notifications Amazon SNS lorsque votre groupe Auto Scaling évolue dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire les stratégies de mise à l’échelle d’un groupe spécifié

Cet exemple décrit les stratégies de mise à l’échelle pour le groupe Auto Scaling spécifié.

aws autoscaling describe-policies \
    --auto-scaling-group-name my-asg

Sortie :

{
    "ScalingPolicies": [
        {
            "AutoScalingGroupName": "my-asg",
            "PolicyName": "alb1000-target-tracking-scaling-policy",
            "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:3065d9c8-9969-4bec-bb6a-3fbe5550fde6:autoScalingGroupName/my-asg:policyName/alb1000-target-tracking-scaling-policy",
            "PolicyType": "TargetTrackingScaling",
            "StepAdjustments": [],
            "Alarms": [
                {
                    "AlarmName": "TargetTracking-my-asg-AlarmHigh-924887a9-12d7-4e01-8686-6f844d13a196",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-924887a9-12d7-4e01-8686-6f844d13a196"
                },
                {
                    "AlarmName": "TargetTracking-my-asg-AlarmLow-f96f899d-b8e7-4d09-a010-c1aaa35da296",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-f96f899d-b8e7-4d09-a010-c1aaa35da296"
                }
            ],
            "TargetTrackingConfiguration": {
                "PredefinedMetricSpecification": {
                    "PredefinedMetricType": "ALBRequestCountPerTarget",
                    "ResourceLabel": "app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff"
                },
                "TargetValue": 1000.0,
                "DisableScaleIn": false
            },
            "Enabled": true
        },
        {
            "AutoScalingGroupName": "my-asg",
            "PolicyName": "cpu40-target-tracking-scaling-policy",
            "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:5fd26f71-39d4-4690-82a9-b8515c45cdde:autoScalingGroupName/my-asg:policyName/cpu40-target-tracking-scaling-policy",
            "PolicyType": "TargetTrackingScaling",
            "StepAdjustments": [],
            "Alarms": [
                {
                    "AlarmName": "TargetTracking-my-asg-AlarmHigh-139f9789-37b9-42ad-bea5-b5b147d7f473",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-139f9789-37b9-42ad-bea5-b5b147d7f473"
                },
                {
                    "AlarmName": "TargetTracking-my-asg-AlarmLow-bd681c67-fc18-4c56-8468-fb8e413009c9",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-bd681c67-fc18-4c56-8468-fb8e413009c9"
                }
            ],
            "TargetTrackingConfiguration": {
                "PredefinedMetricSpecification": {
                    "PredefinedMetricType": "ASGAverageCPUUtilization"
                },
                "TargetValue": 40.0,
                "DisableScaleIn": false
            },
            "Enabled": true
        }
    ]
}

Pour plus d'informations, consultez Dynamic Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour décrire les stratégies de mise à l’échelle d’un nom spécifié

Pour renvoyer des stratégies de mise à l’échelle spécifiques, utilisez l’option --policy-names.

aws autoscaling describe-policies \
    --auto-scaling-group-name my-asg \
    --policy-names cpu40-target-tracking-scaling-policy

Consultez l’exemple 1 pour un exemple de sortie.

Pour plus d'informations, consultez Dynamic Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour décrire un certain nombre de stratégies de mise à l’échelle

Pour renvoyer un nombre spécifique de stratégies, utilisez l’option --max-items.

aws autoscaling describe-policies \
    --auto-scaling-group-name my-asg \
    --max-items 1

Consultez l’exemple 1 pour un exemple de sortie.

Si la sortie inclut un champ NextToken, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur pour obtenir les stratégies supplémentaires.

aws autoscaling describe-policies --auto-scaling-group-name my-asg --starting-token Z3M3LMPEXAMPLE

Pour plus d'informations, consultez Dynamic Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire les activités de mise à l’échelle du groupe spécifié

Cet exemple décrit les activités de mise à l’échelle pour le groupe Auto Scaling spécifié.

aws autoscaling describe-scaling-activities \
    --auto-scaling-group-name my-asg

Sortie :

{
    "Activities": [
        {
            "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699",
            "Description": "Launching a new EC2 instance: i-0d44425630326060f",
            "AutoScalingGroupName": "my-asg",
            "Cause": "At 2020-10-30T19:35:51Z a user request update of AutoScalingGroup constraints to min: 0, max: 16, desired: 16 changing the desired capacity from 0 to 16.  At 2020-10-30T19:36:07Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 16.",
            "StartTime": "2020-10-30T19:36:09.766Z",
            "EndTime": "2020-10-30T19:36:41Z",
            "StatusCode": "Successful",
            "Progress": 100,
            "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}"
        }
    ]
}

Pour plus d'informations, consultez Vérifier une activité de dimensionnement pour un groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour décrire les activités de mise à l’échelle d’un groupe supprimé

Pour décrire les activités de mise à l’échelle après la suppression du groupe Auto Scaling, ajoutez l’option --include-deleted-groups.

aws autoscaling describe-scaling-activities \
    --auto-scaling-group-name my-asg \
    --include-deleted-groups

Sortie :

{
    "Activities": [
        {
            "ActivityId": "e1f5de0e-f93e-1417-34ac-092a76fba220",
            "Description": "Launching a new EC2 instance.  Status Reason: Your Spot request price of 0.001 is lower than the minimum required Spot request fulfillment price of 0.0031. Launching EC2 instance failed.",
            "AutoScalingGroupName": "my-asg",
            "Cause": "At 2021-01-13T20:47:24Z a user request update of AutoScalingGroup constraints to min: 1, max: 5, desired: 3 changing the desired capacity from 0 to 3.  At 2021-01-13T20:47:27Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 3.",
            "StartTime": "2021-01-13T20:47:30.094Z",
            "EndTime": "2021-01-13T20:47:30Z",
            "StatusCode": "Failed",
            "StatusMessage": "Your Spot request price of 0.001 is lower than the minimum required Spot request fulfillment price of 0.0031. Launching EC2 instance failed.",
            "Progress": 100,
            "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}",
            "AutoScalingGroupState": "Deleted",
            "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:283179a2-f3ce-423d-93f6-66bb518232f7:autoScalingGroupName/my-asg"
        }
    ]
}

Pour plus d'informations, consultez Résoudre les problèmes liés à Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour décrire un nombre spécifié d’activités de mise à l’échelle

Pour renvoyer un certain nombre d’activités, utilisez l’option --max-items.

aws autoscaling describe-scaling-activities \
    --max-items 1

Sortie :

{
    "Activities": [
        {
            "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699",
            "Description": "Launching a new EC2 instance: i-0d44425630326060f",
            "AutoScalingGroupName": "my-asg",
            "Cause": "At 2020-10-30T19:35:51Z a user request update of AutoScalingGroup constraints to min: 0, max: 16, desired: 16 changing the desired capacity from 0 to 16.  At 2020-10-30T19:36:07Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 16.",
            "StartTime": "2020-10-30T19:36:09.766Z",
            "EndTime": "2020-10-30T19:36:41Z",
            "StatusCode": "Successful",
            "Progress": 100,
            "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}"
        }
    ]
}

Si la sortie inclut un champ NextToken, il existe d’autres activités. Pour obtenir les activités supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur comme suit.

aws autoscaling describe-scaling-activities \
    --starting-token Z3M3LMPEXAMPLE

Pour plus d'informations, consultez Vérifier une activité de dimensionnement pour un groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour décrire les types de processus disponibles

Cet exemple décrit les types de processus disponibles.

aws autoscaling describe-scaling-process-types

Sortie :

{
    "Processes": [
        {
            "ProcessName": "AZRebalance"
        },
        {
            "ProcessName": "AddToLoadBalancer"
        },
        {
            "ProcessName": "AlarmNotification"
        },
        {
            "ProcessName": "HealthCheck"
        },
        {
            "ProcessName": "InstanceRefresh"
        },
        {
            "ProcessName": "Launch"
        },
        {
            "ProcessName": "ReplaceUnhealthy"
        },
        {
            "ProcessName": "ScheduledActions"
        },
        {
            "ProcessName": "Terminate"
        }
    ]
}

Pour plus d'informations, consultez la section Suspendre et reprise des processus de dimensionnement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour décrire toutes les actions planifiées

Cet exemple décrit toutes vos actions planifiées.

aws autoscaling describe-scheduled-actions

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour décrire les actions planifiées pour le groupe spécifié

Pour décrire les actions planifiées pour un groupe Auto Scaling spécifique, utilisez l’option --auto-scaling-group-name.

aws autoscaling describe-scheduled-actions \
    --auto-scaling-group-name my-asg

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour décrire l’action planifiée spécifiée

Pour décrire une action planifiée spécifique, utilisez l’option --scheduled-action-names.

aws autoscaling describe-scheduled-actions \
    --scheduled-action-names my-recurring-action

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 4 : pour décrire des actions planifiées avec une heure de début spécifiée

Pour décrire les actions planifiées qui démarrent à une heure précise, utilisez l’option --start-time.

aws autoscaling describe-scheduled-actions \
    --start-time "2023-12-01T04:00:00Z"

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 5 : pour décrire des actions planifiées qui se terminent à une heure spécifiée

Pour décrire les actions planifiées qui se terminent à une heure précise, utilisez l’option --end-time.

aws autoscaling describe-scheduled-actions \
    --end-time "2023-12-01T04:00:00Z"

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 6 : pour décrire un nombre spécifié d’actions planifiées

Pour renvoyer un nombre spécifique d’actions planifiées, utilisez l’option --max-items.

aws autoscaling describe-scheduled-actions \
    --auto-scaling-group-name my-asg \
    --max-items 1

Sortie :

{
    "ScheduledUpdateGroupActions": [
        {
            "AutoScalingGroupName": "my-asg",
            "ScheduledActionName": "my-recurring-action",
            "Recurrence": "30 0 1 1,6,12 *",
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action",
            "StartTime": "2023-12-01T04:00:00Z",
            "Time": "2023-12-01T04:00:00Z",
            "MinSize": 1,
            "MaxSize": 6,
            "DesiredCapacity": 4,
            "TimeZone": "America/New_York"
        }
    ]
}

Si la sortie inclut un champ NextToken, il existe d’autres actions planifiées. Pour obtenir les actions planifiées supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur, comme suit.

aws autoscaling describe-scheduled-actions \
    --auto-scaling-group-name my-asg \
    --starting-token Z3M3LMPEXAMPLE

Pour plus d'informations, consultez la section Scheduled Scaling User Guide dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour décrire toutes les balises

Cet exemple décrit toutes vos balises.

aws autoscaling describe-tags

Sortie :

{
    "Tags": [
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "Research",
            "Key": "Dept"
        },
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "WebServer",
            "Key": "Role"
        }
    ]
}

Pour plus d'informations, consultez la section Tagging Auto Scaling groups and instances dans le Amazon EC2 Auto Scaling User Guide.

Exemple 2 : pour décrire les balises d’un groupe spécifique

Pour décrire les balises pour un groupe Auto Scaling spécifique, utilisez l’option --filters.

aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-asg

Pour plus d'informations, consultez la section Tagging Auto Scaling groups and instances dans le Amazon EC2 Auto Scaling User Guide.

Exemple 3 : pour décrire le nombre de balises spécifié

Pour renvoyer un nombre spécifique de balises, utilisez l’option --max-items.

aws autoscaling describe-tags \
    --max-items 1

Si la sortie inclut un champ NextToken, il existe d’autres balises. Pour obtenir les balises supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur, comme suit.

aws autoscaling describe-tags \
    --filters Name=auto-scaling-group,Values=my-asg \
    --starting-token Z3M3LMPEXAMPLE

Pour plus d'informations, consultez la section Tagging Auto Scaling groups and instances dans le Amazon EC2 Auto Scaling User Guide.

Pour décrire les types de politiques de résiliation disponibles

Cet exemple décrit les types de politiques de résiliation disponibles.

aws autoscaling describe-termination-policy-types

Sortie :

{
    "TerminationPolicyTypes": [
        "AllocationStrategy",
        "ClosestToNextInstanceHour",
        "Default",
        "NewestInstance",
        "OldestInstance",
        "OldestLaunchConfiguration",
        "OldestLaunchTemplate"
    ]
}

Pour plus d'informations, consultez la section Contrôler quelles instances Auto Scaling se terminent pendant le dimensionnement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour décrire un groupe d’instances pré-initialisées

Cet exemple décrit le un groupe d’instances pré-initialisées pour le groupe Auto Scaling spécifié.

aws autoscaling describe-warm-pool \
    --auto-scaling-group-name my-asg

Sortie :

{
    "WarmPoolConfiguration": {
        "MinSize": 2,
        "PoolState": "Stopped"
    },
    "Instances": [
        {
            "InstanceId": "i-070a5bbc7e7f40dc5",
            "InstanceType": "t2.micro",
            "AvailabilityZone": "us-west-2c",
            "LifecycleState": "Warmed:Pending",
            "HealthStatus": "Healthy",
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-00a731f6e9fa48610",
                "LaunchTemplateName": "my-template-for-auto-scaling",
                "Version": "6"
            }
        },
        {
            "InstanceId": "i-0b52f061814d3bd2d",
            "InstanceType": "t2.micro",
            "AvailabilityZone": "us-west-2b",
            "LifecycleState": "Warmed:Pending",
            "HealthStatus": "Healthy",
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-00a731f6e9fa48610",
                "LaunchTemplateName": "my-template-for-auto-scaling",
                "Version": "6"
            }
        }
    ]
}

Pour plus d'informations, consultez Warm pools for Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour détacher une instance d’un groupe Auto Scaling

Cet exemple détache l’instance spécifiée du groupe Auto Scaling spécifié.

aws autoscaling detach-instances \
    --instance-ids i-030017cfa84b20135 \
    --auto-scaling-group-name my-asg \
    --should-decrement-desired-capacity

Sortie :

{
    "Activities": [
        {
            "ActivityId": "5091cb52-547a-47ce-a236-c9ccbc2cb2c9",
            "AutoScalingGroupName": "my-asg",
            "Description": "Detaching EC2 instance: i-030017cfa84b20135",
            "Cause": "At 2020-10-31T17:35:04Z instance i-030017cfa84b20135 was detached in response to a user request, shrinking the capacity from 2 to 1.",
            "StartTime": "2020-04-12T15:02:16.179Z",
            "StatusCode": "InProgress",
            "Progress": 50,
            "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}"
        }
    ]
}

Pour détacher un groupe cible de l’équilibreur de charge d’un groupe Auto Scaling

Cet exemple détache le groupe cible de l’équilibreur de charge spécifié du groupe Auto Scaling spécifié.

aws autoscaling detach-load-balancer-target-groups \
    --auto-scaling-group-name my-asg \
    --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Attacher un équilibreur de charge à votre groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour détacher un Classic Load Balancer d’un groupe Auto Scaling

Cet exemple détache le Classic Load Balancer spécifié du groupe Auto Scaling spécifié.

aws autoscaling detach-load-balancers \
    --load-balancer-names my-load-balancer \
    --auto-scaling-group-name my-asg

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Attacher un équilibreur de charge à votre groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour désactiver les collectes de métriques pour un groupe Auto Scaling

Cet exemple désactive la collecte de la métrique GroupDesiredCapacity pour le groupe Auto Scaling spécifié.

aws autoscaling disable-metrics-collection \
    --auto-scaling-group-name my-asg \
    --metrics GroupDesiredCapacity

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Surveillance CloudWatch des métriques pour vos groupes et instances Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour activer la collecte de métriques pour un groupe Auto Scaling

Cet exemple active la collecte de données pour le groupe Auto Scaling spécifié.

aws autoscaling enable-metrics-collection \
    --auto-scaling-group-name my-asg \
    --granularity "1Minute"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Surveillance CloudWatch des métriques pour vos groupes et instances Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour collecter des données pour la métrique spécifiée pour un groupe Auto Scaling

Pour collecter des données pour une métrique spécifique, utilisez l’option --metrics.

aws autoscaling enable-metrics-collection \
    --auto-scaling-group-name my-asg \
    --metrics GroupDesiredCapacity --granularity "1Minute"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Surveillance CloudWatch des métriques pour vos groupes et instances Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour déplacer des instances en mode veille

Cet exemple met l’instance spécifiée en mode veille. Cela est utile pour mettre à jour ou dépanner une instance actuellement en service.

aws autoscaling enter-standby \
    --instance-ids i-061c63c5eb45f0416 \
    --auto-scaling-group-name my-asg \
    --should-decrement-desired-capacity

Sortie :

{
    "Activities": [
        {
            "ActivityId": "ffa056b4-6ed3-41ba-ae7c-249dfae6eba1",
            "AutoScalingGroupName": "my-asg",
            "Description": "Moving EC2 instance to Standby: i-061c63c5eb45f0416",
            "Cause": "At 2020-10-31T20:31:00Z instance i-061c63c5eb45f0416 was moved to standby in response to a user request, shrinking the capacity from 1 to 0.",
            "StartTime": "2020-10-31T20:31:00.949Z",
            "StatusCode": "InProgress",
            "Progress": 50,
            "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}"
        }
    ]
}

Pour plus d'informations, consultez le cycle de vie des instances Amazon EC2 Auto Scaling dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Pour exécuter une stratégie de mise à l’échelle

Cet exemple exécute la stratégie de mise à l’échelle my-step-scale-out-policy pour le groupe Auto Scaling spécifié.

aws autoscaling execute-policy \
    --auto-scaling-group-name my-asg \
    --policy-name  my-step-scale-out-policy \
    --metric-value 95 \
    --breach-threshold 80

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Step and Simple Scaling policies dans le manuel Amazon EC2 Auto Scaling User Guide.

Pour sortir les instances du mode veille

Cet exemple sort l’instance spécifiée du mode veille.

aws autoscaling exit-standby \
    --instance-ids i-061c63c5eb45f0416 \
    --auto-scaling-group-name my-asg

Sortie :

{
    "Activities": [
        {
            "ActivityId": "142928e1-a2dc-453a-9b24-b85ad6735928",
            "AutoScalingGroupName": "my-asg",
            "Description": "Moving EC2 instance out of Standby: i-061c63c5eb45f0416",
            "Cause": "At 2020-10-31T20:32:50Z instance i-061c63c5eb45f0416 was moved out of standby in response to a user request, increasing the capacity from 0 to 1.",
            "StartTime": "2020-10-31T20:32:50.222Z",
            "StatusCode": "PreInService",
            "Progress": 30,
            "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}"
        }
    ]
}

Pour plus d'informations, consultez la section Suppression temporaire d'instances de votre groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 1 : pour créer un hook de cycle de vie

Cet exemple crée un hook de cycle de vie qui sera invoqué sur toutes les instances nouvellement lancées, avec un délai d’expiration de 4 800 secondes. Cela est utile pour maintenir les instances en état d'attente jusqu'à ce que les scripts de données utilisateur soient terminés, ou pour appeler une fonction AWS Lambda à l'aide de. EventBridge

aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name my-asg \
    --lifecycle-hook-name my-launch-hook \
    --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \
    --heartbeat-timeout 4800

Cette commande ne produit aucune sortie. Si un hook de cycle de vie portant le même nom existe déjà, il sera remplacé par le nouveau hook de cycle de vie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour envoyer un e-mail Amazon SNS afin de vous notifier des transitions d’état de l’instance

Cet exemple crée un hook de cycle de vie avec la rubrique Amazon SNS et le rôle IAM à utiliser pour recevoir des notifications au lancement de l’instance.

aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name my-asg \
    --lifecycle-hook-name my-launch-hook \
    --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \
    --notification-target-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic \
    --role-arn arn:aws:iam::123456789012:role/my-auto-scaling-role

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour publier un message dans une file d’attente Amazon SQS

Cet exemple crée un hook de cycle de vie qui publie un message contenant des métadonnées dans la file d’attente Amazon SQS spécifiée.

aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name my-asg \
    --lifecycle-hook-name my-launch-hook \
    --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \
    --notification-target-arn arn:aws:sqs:us-west-2:123456789012:my-sqs-queue \
    --role-arn arn:aws:iam::123456789012:role/my-notification-role \
    --notification-metadata "SQS message metadata"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour ajouter une notification

Cet exemple ajoute la notification spécifiée au groupe Auto Scaling spécifié.

aws autoscaling put-notification-configuration \
    --auto-scaling-group-name my-asg \
    --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic \
    --notification-type autoscaling:TEST_NOTIFICATION

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Recevoir des notifications Amazon SNS lorsque votre groupe Auto Scaling évolue dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour créer une politique de suivi des cibles et d’échelonnement pour un groupe Auto Scaling

L’exemple put-scaling-policy suivant applique une politique de suivi des cibles et d’échelonnement au groupe Auto Scaling spécifié. La sortie contient les noms ARNs et les noms des deux CloudWatch alarmes créées en votre nom. Si une stratégie de mise à l’échelle portant le même nom existe déjà, elle sera remplacée par la nouvelle stratégie de mise à l’échelle.

aws autoscaling put-scaling-policy --auto-scaling-group-name my-asg \
  --policy-name alb1000-target-tracking-scaling-policy \
  --policy-type TargetTrackingScaling \
  --target-tracking-configuration file://config.json

Contenu de config.json :

{
     "TargetValue": 1000.0,
     "PredefinedMetricSpecification": {
          "PredefinedMetricType": "ALBRequestCountPerTarget",
          "ResourceLabel": "app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff"
     }
}

Sortie :

{
     "PolicyARN": "arn:aws:autoscaling:region:account-id:scalingPolicy:228f02c2-c665-4bfd-aaac-8b04080bea3c:autoScalingGroupName/my-asg:policyName/alb1000-target-tracking-scaling-policy",
     "Alarms": [
         {
             "AlarmARN": "arn:aws:cloudwatch:region:account-id:alarm:TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e",
             "AlarmName": "TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e"
         },
         {
             "AlarmARN": "arn:aws:cloudwatch:region:account-id:alarm:TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2",
             "AlarmName": "TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2"
         }
     ]
 }

Pour plus d'exemples, consultez la section Exemples de politiques de dimensionnement pour l'interface de ligne de AWS commande (AWS CLI) dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 1 : pour ajouter une action planifiée à un groupe Auto Scaling

Cet exemple ajoute l’action planifiée spécifiée au groupe Auto Scaling spécifié.

aws autoscaling put-scheduled-update-group-action \
    --auto-scaling-group-name my-asg \
    --scheduled-action-name my-scheduled-action \
    --start-time "2023-05-12T08:00:00Z" \
    --min-size 2 \
    --max-size 6 \
    --desired-capacity 4

Cette commande ne produit aucune sortie. Si une action planifiée portant le même nom existe déjà, elle sera remplacée par la nouvelle action planifiée.

Pour plus d'exemples, consultez Scheduled Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour spécifier un calendrier récurrent

Cet exemple crée une action planifiée à mettre en œuvre selon un calendrier récurrent dont l’exécution est prévue à 00 h 30 les 1er janvier, juin et décembre de chaque année.

aws autoscaling put-scheduled-update-group-action \
    --auto-scaling-group-name my-asg \
    --scheduled-action-name my-recurring-action \
    --recurrence "30 0 1 1,6,12 *" \
    --min-size 2 \
    --max-size 6 \
    --desired-capacity 4

Cette commande ne produit aucune sortie. Si une action planifiée portant le même nom existe déjà, elle sera remplacée par la nouvelle action planifiée.

Pour plus d'exemples, consultez Scheduled Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour créer un groupe d’instances pré-initialisées

L’exemple suivant crée un groupe d’instances pré-initialisées pour le groupe Auto Scaling spécifié.

aws autoscaling put-warm-pool \
    --auto-scaling-group-name my-asg \
    --min-size 2

Cette commande ne produit aucune sortie. Si un groupe d’instances pré-initialisées existe déjà, il sera mis à jour.

Pour plus d'informations, consultez Warm pools for Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour enregistrer les pulsations d’une action du cycle de vie

Cet exemple enregistre les pulsations d’une action du cycle de vie afin de maintenir l’instance dans un état d’attente.

aws autoscaling record-lifecycle-action-heartbeat \
    --lifecycle-hook-name my-launch-hook \
    --auto-scaling-group-name my-asg \
    --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez les hooks du cycle de vie d'Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour reprendre des processus suspendus

Cet exemple reprend le processus de mise à l’échelle suspendu spécifié pour le groupe Auto Scaling spécifié.

aws autoscaling resume-processes \
    --auto-scaling-group-name my-asg \
    --scaling-processes AlarmNotification

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Suspendre et reprise des processus de dimensionnement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour restaurer une actualisation d’instance

L’exemple rollback-instance-refresh suivant restaure une actualisation d’instance en cours pour le groupe Auto Scaling spécifié.

aws autoscaling rollback-instance-refresh \
    --auto-scaling-group-name my-asg

Sortie :

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

Pour plus d'informations, consultez la section Annuler les modifications par une annulation dans le manuel Amazon EC2 Auto Scaling User Guide.

Pour définir la capacité souhaitée pour un groupe Auto Scaling

Cet exemple définit la capacité souhaitée pour le groupe Auto Scaling spécifié.

aws autoscaling set-desired-capacity \
    --auto-scaling-group-name my-asg \
    --desired-capacity 2 \
    --honor-cooldown

Cette commande revient à l’invite en cas de succès.

Pour définir le statut d’état d’une instance

Cet exemple définit le statut d’état de l’instance spécifiée sur Unhealthy.

aws autoscaling set-instance-health \
    --instance-id i-061c63c5eb45f0416 \
    --health-status Unhealthy

Cette commande ne produit aucune sortie.

Exemple 1 : pour activer le paramètre de protection d’instance pour une instance

Cet exemple active la protection d’instance pour l’instance spécifiée.

aws autoscaling set-instance-protection \
    --instance-ids i-061c63c5eb45f0416 \
    --auto-scaling-group-name my-asg --protected-from-scale-in

Cette commande ne produit aucune sortie.

Exemple 2 : pour désactiver le paramètre de protection d’instance pour une instance

Cet exemple désactive la protection d’instance pour l’instance spécifiée.

aws autoscaling set-instance-protection \
    --instance-ids i-061c63c5eb45f0416 \
    --auto-scaling-group-name my-asg \
    --no-protected-from-scale-in

Cette commande ne produit aucune sortie.

Exemple 1 : pour démarrer l’actualisation d’une instance à l’aide des paramètres de ligne de commande

L’exemple start-instance-refresh suivant lance une actualisation d’instance à l’aide d’arguments de ligne de commande. Le paramètre preferences facultatif spécifie un InstanceWarmup de 60 secondes et un MinHealthyPercentage de 50 %.

aws autoscaling start-instance-refresh \
    --auto-scaling-group-name my-asg \
    --preferences '{"InstanceWarmup": 60, "MinHealthyPercentage": 50}'

Sortie :

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

Pour plus d'informations, consultez Démarrer l'actualisation d'une instance dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Exemple 2 : pour démarrer l’actualisation d’une instance à l’aide d’un fichier JSON

L’exemple start-instance-refresh suivant lance une actualisation d’instance à l’aide d’un fichier JSON. Vous pouvez spécifier le groupe Auto Scaling et définir la configuration et les préférences de votre choix dans un fichier JSON, comme illustré dans l’exemple suivant.

aws autoscaling start-instance-refresh \
    --cli-input-json file://config.json

Contenu de config.json :

{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
        "LaunchTemplate": {
            "LaunchTemplateId": "lt-068f72b729example",
            "Version": "$Default"
        }
    },
    "Preferences": {
        "InstanceWarmup": 60,
        "MinHealthyPercentage": 50,
        "AutoRollback": true,
        "ScaleInProtectedInstances": Ignore,
        "StandbyInstances": Terminate
    }
}

Sortie :

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

Pour plus d'informations, consultez Démarrer l'actualisation d'une instance dans le guide de l'utilisateur Amazon EC2 Auto Scaling.

Pour suspendre les processus Auto Scaling

Cet exemple suspend le processus de mise à l’échelle spécifié pour le groupe Auto Scaling spécifié.

aws autoscaling suspend-processes \
    --auto-scaling-group-name my-asg \
    --scaling-processes AlarmNotification

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Suspendre et reprise des processus de dimensionnement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour résilier une instance de votre groupe Auto Scaling

Cet exemple résilie l’instance spécifiée à partir du groupe Auto Scaling spécifié sans mettre à jour la taille du groupe. Amazon EC2 Auto Scaling lance une instance de remplacement après la fin de l'instance spécifiée.

aws autoscaling terminate-instance-in-auto-scaling-group \
    --instance-id i-061c63c5eb45f0416 \
    --no-should-decrement-desired-capacity

Sortie :

{
    "Activities": [
        {
            "ActivityId": "8c35d601-793c-400c-fcd0-f64a27530df7",
            "AutoScalingGroupName": "my-asg",
            "Description": "Terminating EC2 instance: i-061c63c5eb45f0416",
            "Cause": "",
            "StartTime": "2020-10-31T20:34:25.680Z",
            "StatusCode": "InProgress",
            "Progress": 0,
            "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}"
        }
    ]
}

Exemple 1 : pour mettre à jour les limites de taille d’un groupe Auto Scaling

Cet exemple met à jour le groupe Auto Scaling spécifié avec une taille minimale égale à 2 et une taille maximale égale à 10.

aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --min-size 2 \
    --max-size 10

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Définition des limites de capacité pour votre groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 2 : pour ajouter des surveillances de l’état Elastic Load Balancing et spécifier les zones de disponibilité et les sous-réseaux à utiliser

Cet exemple met à jour le groupe Auto Scaling spécifié pour ajouter des surveillances de l’état Elastic Load Balancing. Cette commande met également à jour la valeur de --vpc-zone-identifier avec une liste de sous-réseaux IDs dans plusieurs zones de disponibilité.

aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --health-check-type ELB \
    --health-check-grace-period 600 \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Elastic Load Balancing et Amazon EC2 Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 3 : pour mettre à jour le groupe de placement et la politique de résiliation

Cet exemple met à jour le groupe de placement et la stratégie de résiliation à utiliser.

aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --placement-group my-placement-group \
    --termination-policies "OldestInstance"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Groupes Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 4 : Pour utiliser la dernière version du modèle de lancement

Cet exemple met à jour le groupe Auto Scaling pour utiliser la dernière version du modèle de lancement spécifié.

aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest'

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Modèles de lancement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 5 : pour utiliser une version spécifique du modèle de lancement

Cet exemple met à jour le groupe Auto Scaling spécifié pour utiliser une version spécifique d’un modèle de lancement au lieu de la dernière version ou de la version par défaut.

aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='2'

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Modèles de lancement dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Exemple 6 : pour définir une politique d’instances mixtes et activer le rééquilibrage des capacités

Cet exemple met à jour le groupe Auto Scaling spécifié afin d’utiliser une politique d’instances mixtes et d’activer le rééquilibrage des capacités. Cette structure vous permet de spécifier des groupes dotés de capacités Spot et à la demande et d’utiliser différents modèles de lancement pour différentes architectures.

aws autoscaling update-auto-scaling-group \
    --cli-input-json file://~/config.json

Contenu de config.json :

{
    "AutoScalingGroupName": "my-asg",
    "CapacityRebalance": true,
    "MixedInstancesPolicy": {
        "LaunchTemplate": {
            "LaunchTemplateSpecification": {
                "LaunchTemplateName": "my-launch-template-for-x86",
                "Version": "$Latest"
            },
            "Overrides": [
                {
                    "InstanceType": "c6g.large",
                    "LaunchTemplateSpecification": {
                        "LaunchTemplateName": "my-launch-template-for-arm",
                        "Version": "$Latest"
                    }
                },
                {
                    "InstanceType": "c5.large"
                },
                {
                    "InstanceType": "c5a.large"
                }
            ]
        },
        "InstancesDistribution": {
            "OnDemandPercentageAboveBaseCapacity": 50,
            "SpotAllocationStrategy": "capacity-optimized"
        }
    }
}

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Groupes Auto Scaling avec plusieurs types d'instances et options d'achat dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.