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 aucun résultat.

Pour associer 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 aucun résultat.

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 associer 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 aucun résultat.

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 l'actualisation d'une instance

L'cancel-instance-refreshexemple 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 d'Amazon EC2 Auto Scaling.

Pour terminer l'action du 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 aucun résultat.

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'create-auto-scaling-groupexemple 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 du bilan de santé.

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 aucun résultat.

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

Exemple 2 : pour associer 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 bilan de santé indique ELB que lorsqu'Elastic Load Balancing signale qu'une instance est défectueuse, le groupe Auto Scaling la remplace. La commande définit également un délai de grâce en 600 secondes pour le contrôle de santé. Le délai 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 aucun résultat.

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 au sein d'une seule 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 aucun résultat.

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 une instance unique, le groupe Auto Scaling 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 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'un ENI existant 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 aucun résultat.

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 mettre fin aux instances les plus anciennes en premier. La commande applique également une balise au groupe et à ses instances, avec une clé Role et une valeur deWebServer.

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 aucun résultat.

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 du 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 config.json fichier :

{
    "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 aucun résultat.

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 du cycle de vie de terminaison

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 fermeture 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 aucun résultat.

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 définir 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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

Pour plus d'informations, consultez la section Configuration de la surveillance pour les instances Auto Scaling dans le guide de l'utilisateur d'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 aucun résultat.

Pour plus d'informations, consultez la section 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 aucun résultat.

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ériques en mode bloc pour un volume Amazon EBS

Cet exemple crée une configuration de lancement avec un mappage de périphériques par blocs pour un gp3 volume Amazon EBS avec le nom de l'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 aucun résultat.

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ériques en mode bloc pour un volume de stockage d'instance

Cet exemple crée une configuration de lancement avec ephemeral1 comme instance un volume de stockage avec le nom de l'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 aucun résultat.

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 bloqué de se connecter au moment du lancement

Cet exemple crée une configuration de lancement qui supprime un périphérique en mode bloc spécifié par le mappage des périphériques 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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

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 terminent, utilisez l'--force-deleteoption.

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

Cette commande ne produit aucun résultat.

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 aucun résultat.

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 du 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 aucun résultat.

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 aucun résultat.

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

Pour supprimer une politique de dimensionnement

Cet exemple supprime la politique de dimensionnement spécifiée.

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

Cette commande ne produit aucun résultat.

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 aucun résultat.

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 aucun résultat.

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 pool de chaleur

L'exemple suivant supprime le pool de chaleur pour le groupe Auto Scaling spécifié.

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

Cette commande ne produit aucun résultat.

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 pool de chaleur

Pour supprimer le pool de chaleur sans attendre que ses instances se terminent, utilisez l'--force-deleteoption.

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

Cette commande ne produit aucun résultat.

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 de réglage de mise à l'échelle disponibles

Cet exemple décrit les types de réglage 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 mise à l'échelle 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 groupes.

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

Voir 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'à un maximum de 75 groupes.

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

Voir 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'--max-itemsoption.

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

Voir l’exemple 1 pour un exemple de sortie.

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

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

Voir 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'--queryoption 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'--max-itemsoption 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 NextToken champ, il y a d'autres instances. Pour obtenir les instances supplémentaires, utilisez la valeur de ce champ avec l'--starting-tokenoption lors d'un appel suivant, comme suit.

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

Voir 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'--queryoption 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 les actualisations d'instances

L'describe-instance-refreshesexemple suivant renvoie une description de toutes les demandes d'actualisation d'instance pour le groupe Auto Scaling spécifié, y compris le message d'état 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'--max-itemsoption.

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

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

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

Pour décrire les types de crochets 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 crochets liés au cycle de vie

Cet exemple décrit les hooks du 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 d'équilibreurs de charge pour un groupe Auto Scaling

Cet exemple décrit les groupes cibles d'équilibreurs 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 équilibreurs de charge classiques pour un groupe Auto Scaling

Cet exemple décrit les équilibreurs de charge classiques 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 collecte de mesures disponibles

Cet exemple décrit les types de collecte 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 max-items paramètre.

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 NextToken champ, il existe d'autres configurations de notification. Pour obtenir les configurations de notification supplémentaires, utilisez la valeur de ce champ avec le starting-token paramètre lors d'un appel suivant 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 politiques de dimensionnement d'un groupe spécifié

Cet exemple décrit les politiques de dimensionnement 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 politiques de dimensionnement d'un nom spécifié

Pour renvoyer des politiques de dimensionnement spécifiques, utilisez l'--policy-namesoption.

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

Voir 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 politiques de dimensionnement

Pour renvoyer un nombre spécifique de politiques, utilisez l'--max-itemsoption.

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

Voir l’exemple 1 pour un exemple de sortie.

Si la sortie inclut un NextToken champ, utilisez la valeur de ce champ avec l'--starting-tokenoption lors d'un appel ultérieur pour obtenir les politiques 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 dimensionnement pour le groupe spécifié

Cet exemple décrit les activités de dimensionnement 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 dimensionnement pour un groupe supprimé

Pour décrire les activités de dimensionnement après la suppression du groupe Auto Scaling, ajoutez l'--include-deleted-groupsoption.

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'--max-itemsoption.

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 NextToken champ, il y a d'autres activités. Pour obtenir les activités supplémentaires, utilisez la valeur de ce champ avec l'--starting-tokenoption lors d'un appel suivant 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'--auto-scaling-group-nameoption.

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'--scheduled-action-namesoption.

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'--start-timeoption.

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 les actions planifiées qui se terminent à une heure spécifiée

Pour décrire les actions planifiées qui se terminent à un moment précis, utilisez l'--end-timeoption.

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'--max-itemsoption.

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 NextToken champ, d'autres actions sont planifiées. Pour obtenir les actions planifiées supplémentaires, utilisez la valeur de ce champ avec l'--starting-tokenoption lors d'un appel suivant, 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 tous les tags

Cet exemple décrit tous vos tags.

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 d'un groupe Auto Scaling spécifique, utilisez l'--filtersoption.

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'--max-itemsoption.

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

Si la sortie inclut un NextToken champ, il y a d'autres balises. Pour obtenir les balises supplémentaires, utilisez la valeur de ce champ avec l'--starting-tokenoption lors d'un appel suivant 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 une piscine chaude

Cet exemple décrit le pool de chaleur 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 d'équilibreurs de charge d'un groupe Auto Scaling

Cet exemple détache le groupe cible d'équilibreurs 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 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é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 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ésactiver la collecte de métriques pour un groupe Auto Scaling

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

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

Cette commande ne produit aucun résultat.

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 aucun résultat.

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'--metricsoption.

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

Cette commande ne produit aucun résultat.

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 politique de dimensionnement

Cet exemple exécute la politique de dimensionnement nommée 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 aucun résultat.

Pour plus d'informations, consultez Step and Simple Scaling policies dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

Pour sortir les instances du mode veille

Cet exemple fait sortir 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 aucun résultat. 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 pour vous informer des transitions d'état d'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 lors du 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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

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 ajouter une politique de dimensionnement du suivi des cibles à un groupe Auto Scaling

L'put-scaling-policyexemple suivant applique une politique de dimensionnement du suivi des cibles 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 dimensionnement portant le même nom existe déjà, elle sera remplacée par la nouvelle stratégie de dimensionnement.

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 aucun résultat. 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 définir un calendrier récurrent

Cet exemple crée une action planifiée pour s'adapter à un calendrier récurrent dont l'exécution est prévue à 00h30 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 aucun résultat. 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 une piscine chaude

L'exemple suivant crée un pool de chaleur 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 aucun résultat. Si une piscine chaude existe déjà, elle sera mise à 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 le rythme cardiaque d'une action pendant le cycle de vie

Cet exemple enregistre le rythme cardiaque d'une action du cycle de vie afin de maintenir l'instance en 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 aucun résultat.

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 les processus suspendus

Cet exemple reprend le processus de dimensionnement 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 aucun résultat.

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 annuler l'actualisation d'une instance

L'rollback-instance-refreshexemple suivant annule 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 l'état de santé d'une instance

Cet exemple définit l'état de santé de l'instance spécifiée surUnhealthy.

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

Cette commande ne produit aucun résultat.

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

Cet exemple active la protection de l'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 aucun résultat.

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

Cet exemple désactive la protection de l'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 aucun résultat.