Beispiele für die Verwendung der AWS CLI mit Auto Scaling

So fügen Sie eine Instance zu einer Auto-Scaling-Gruppe hinzu

In diesem Beispiel wird die angegebene Instance an die spezifizierte Auto-Scaling-Gruppe angehängt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So fügen Sie einer Auto-Scaling-Gruppe eine Zielgruppe hinzu

In diesem Beispiel wird die angegebene Zielgruppe zur spezifizierten Auto-Scaling-Gruppe hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Elastic Load Balancing und Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So fügen Sie einer Auto-Scaling-Gruppe einen Classic Load Balancer hinzu

In diesem Beispiel wird der angegebene Classic Load Balancer der spezifizierten Auto-Scaling-Gruppe hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Elastic Load Balancing und Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So brechen Sie eine Instance-Aktualisierung ab

Im folgenden Beispiel für cancel-instance-refresh wird eine laufende Instance-Aktualisierung für die angegebene Auto-Scaling-Gruppe abgebrochen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Abbrechen einer Instance-Aktualisierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So schließen Sie eine Lebenszyklusaktion ab

In diesem Beispiel wird Amazon EC2 Auto Scaling darüber informiert, dass die angegebene Lebenszyklusaktion abgeschlossen ist, sodass das Starten oder Beenden der Instance abgeschlossen werden kann.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So erstellen Sie eine Auto-Scaling-Gruppe

Das folgende create-auto-scaling-group-Beispiel erstellt eine Auto-Scaling-Gruppe in Subnetzen in mehreren Availability Zones innerhalb einer Region. Die Instances werden mit der Standardversion der angegebenen Startvorlage gestartet. Bitte beachten Sie, dass für die meisten anderen Einstellungen, wie z. B. die Beendigungsrichtlinien und die Konfiguration der Zustandsprüfung, die Standardeinstellungen verwendet werden.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen zu Auto-Scaling-Gruppen finden Sie im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So fügen Sie einen Application Load Balancer, einen Network Load Balancer oder einen Gateway Load Balancer hinzu

Dieses Beispiel gibt den ARN einer Zielgruppe für einen Load Balancer an, der den erwarteten Datenverkehr unterstützt. Der Typ der Zustandsprüfung gibt ELB an, sodass die Auto-Scaling-Gruppe eine Instance ersetzt, wenn Elastic Load Balancing diese als fehlerhaft meldet. Der Befehl definiert außerdem eine Wartefrist für die Zustandsprüfung von 600 Sekunden. Die Wartefrist trägt dazu bei, ein vorzeitiges Beenden neu gestarteter Instances zu verhindern.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Elastic Load Balancing und Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 3: So geben Sie eine Platzierungsgruppe an und verwenden die neueste Version der Startvorlage

Dieses Beispiel startet Instances in einer Platzierungsgruppe innerhalb einer einzelnen Availability Zone. Dies kann für Gruppen mit niedriger Latenz und HPC-Workloads nützlich sein. Außerdem werden in diesem Beispiel die minimale Größe, die maximale Größe und die gewünschte Kapazität der Gruppe angegeben.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Platzierungsgruppen im Amazon-EC2-Benutzerhandbuch zu Linux-Instances.

Beispiel 4: So geben Sie eine Auto-Scaling-Gruppe mit einer einzelnen Instance an und verwenden eine bestimmte Version der Startvorlage

Dieses Beispiel erstellt eine Auto-Scaling-Gruppe mit einer minimalen und maximalen Kapazität von 1, um sicherzustellen, dass eine Instance ausgeführt wird. Der Befehl gibt außerdem Version 1 einer Startvorlage an, in der die ID einer vorhandenen ENI angegeben ist. Wenn Sie eine Startvorlage verwenden, die eine vorhandene ENI für eth0 angibt, müssen Sie für die Auto-Scaling-Gruppe eine Availability Zone angeben, die mit der Netzwerkschnittstelle übereinstimmt, ohne in der Anforderung zusätzlich eine Subnetz-ID anzugeben.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen zu Auto-Scaling-Gruppen finden Sie im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 5: So geben Sie eine andere Beendigungsrichtlinie an

In diesem Beispiel wird eine Auto-Scaling-Gruppe mithilfe einer Startkonfiguration erstellt und die Beendigungsrichtlinie so festgelegt, dass die ältesten Instances zuerst beendet werden. Der Befehl weist außerdem der Gruppe und ihren Instances ein Tag mit dem Schlüssel Role und dem Wert WebServer zu.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit Beendigungsrichtlinien für Amazon EC2 Auto Scaling im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 6: So geben Sie einen Start-Lebenszyklus-Hook an

Das folgende Beispiel erstellt eine Auto-Scaling-Gruppe mit einem Lebenszyklus-Hook, der eine benutzerdefinierte Aktion beim Starten einer Instance unterstützt.

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

Inhalt der config.json-Datei:

{
    "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"
    }]
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 7: So geben Sie einen Beendigungs-Lebenszyklus-Hook an

Das folgende Beispiel erstellt eine Auto-Scaling-Gruppe mit einem Lebenszyklus-Hook, der eine benutzerdefinierte Aktion beim Beenden einer Instance unterstützt.

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

Inhalt von 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"
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 8: So geben Sie eine benutzerdefinierte Beendigungsrichtlinie an

In diesem Beispiel wird eine Auto-Scaling-Gruppe erstellt, die eine benutzerdefinierte Lambda-Funktionsrichtlinie für Beendigungen angibt, die Amazon EC2 Auto Scaling mitteilt, welche Instances sicher beim Abskalieren beendet werden können.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten Beendigungsrichtlinie mit Lambda im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So erstellen Sie eine Startkonfiguration

In diesem Beispiel wird eine einfache Startkonfiguration erstellt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer Startkonfiguration im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So erstellen Sie eine Startkonfiguration mit einer Sicherheitsgruppe, einem Schlüsselpaar und einem Bootrapping-Skript

In diesem Beispiel wird eine Startkonfiguration mit einer Sicherheitsgruppe, einem Schlüsselpaar und einem Bootrapping-Skript erstellt, die in den Benutzerdaten enthalten sind.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer Startkonfiguration im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 3: So erstellen Sie eine Startkonfiguration mit einer IAM-Rolle

In diesem Beispiel wird eine Startkonfiguration mit dem Instance-Profilnamen einer IAM-Rolle erstellt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter IAM-Rolle für Anwendungen, die auf Amazon EC2-Instances ausgeführt werden im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 4: So erstellen Sie eine Startkonfiguration mit aktivierter detaillierter Überwachung

In diesem Beispiel wird eine Startkonfiguration mit aktivierter detaillierter EC2-Überwachung erstellt, die EC2-Metriken in Intervallen von 1 Minute an CloudWatch sendet.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Konfigurieren der Überwachung für Auto-Scaling-Instances im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 5: So erstellen Sie eine Startkonfiguration, die Spot Instances startet

In diesem Beispiel wird eine Startkonfiguration erstellt, die Spot Instances als einzige Kaufoption verwendet.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Anfordern von Spot Instances im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 6: So erstellen Sie eine Startkonfiguration unter Verwendung einer EC2-Instance

In diesem Beispiel wird eine Startkonfiguration erstellt, die auf den Attributen einer vorhandenen Instance basiert. Es überschreibt die Tenancy für die Platzierung und ob eine öffentliche IP-Adresse festgelegt wird, indem die Optionen --placement-tenancy und --no-associate-public-ip-address einbezogen werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer Startkonfiguration mithilfe einer EC2-Instance im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 7: So erstellen Sie eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Amazon EBS-Volume

In diesem Beispiel wird eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Amazon-EBS-gp3Volume mit dem Gerätenamen /dev/sdh und einer Volume-Größe von 20 erstellt.

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"}}]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter EBS in der API-Referenz zum Amazon EC2 Auto Scaling.

Informationen zur Syntax beim Zitieren von JSON-formatierten Parameterwerten finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS im Benutzerhandbuch zur AWS-Befehlszeilenschnittstelle.

Beispiel 8: So erstellen Sie eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Instance-Speicher-Volume

In diesem Beispiel wird eine Startkonfiguration mit ephemeral1 als Instance-Speicher-Volume mit dem Gerätenamen /dev/sdc erstellt.

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"}]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter BlockDeviceMapping in der API-Referenz zu Amazon EC2 Auto Scaling.

Informationen zur Syntax beim Zitieren von JSON-formatierten Parameterwerten finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS im Benutzerhandbuch zur AWS-Befehlszeilenschnittstelle.

Beispiel 9: So erstellen Sie eine Startkonfiguration und verhindern, dass ein Blockgerät beim Start eine Verbindung herstellt

In diesem Beispiel wird eine Startkonfiguration erstellt, die das Blockgerät unterdrückt, das in der Blockgerät-Zuordnung des AMI angegeben ist (z. B. /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":""}]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter BlockDeviceMapping in der API-Referenz zu Amazon EC2 Auto Scaling.

Informationen zur Syntax beim Zitieren von JSON-formatierten Parameterwerten finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS im Benutzerhandbuch zur AWS-Befehlszeilenschnittstelle.

So erstellen oder ändern Sie Tags für eine vorhandene Auto-Scaling-Gruppe

In diesem Beispiel werden der angegebenen Auto-Scaling-Gruppe zwei Tags hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markieren von Auto Scaling-Gruppen und Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So löschen Sie die angegebene Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen der Auto-Scaling-Infrastruktur im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So erzwingen Sie das Löschen der angegebenen Auto-Scaling-Gruppe

Löschen Sie die Auto-Scaling-Gruppe, ohne darauf zu warten, dass die Instances in der Gruppe beendet werden, indem Sie die --force-delete-Option verwenden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen der Auto-Scaling-Infrastruktur im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So löschen Sie eine Startkonfiguration

In diesem Beispiel wird die angegebene Startkonfiguration gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen der Auto-Scaling-Infrastruktur im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So löschen Sie einen Lebenszyklus-Hook

In diesem Beispiel wird der angegebene Lebenszyklus-Hook gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie eine Auto-Scaling-Benachrichtigung

In diesem Beispiel wird die angegebene Benachrichtigung aus der spezifizierten Auto-Scaling-Gruppe gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen der Benachrichtigungskonfiguration im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So löschen Sie eine Skalierungsrichtlinie

In diesem Beispiel wird die angegebene Scaling-Richtlinie gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie eine geplante Aktion aus einer Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene geplante Aktion aus der spezifizierten Auto-Scaling-Gruppe gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie ein Tag aus einer Auto-Scaling-Gruppe

In diesem Beispiel wird das angegebene Tag aus der angegebenen Auto-Scaling-Gruppe gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markieren von Auto Scaling-Gruppen und Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So löschen Sie einen warmen Pool

Im folgenden Beispiel wird ein warmer Pool für die angegebene Auto-Scaling-Gruppe gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Warm-Pools für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 2: So erzwingen Sie das Löschen eines warmen Pools

Verwenden Sie die Option --force-delete, um den warmen Pool zu löschen, ohne darauf zu warten, dass seine Instances beendet werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Warm-Pools für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So beschreiben Sie die Limits Ihres Kontos bei Amazon EC2 Auto Scaling

In diesem Beispiel werden die Beschränkungen von Amazon EC2 Auto Scaling für Ihr AWS-Konto beschrieben.

aws autoscaling describe-account-limits

Ausgabe:

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

Weitere Informationen finden Sie unter Servicekontingente für Amazon EC2 Auto Scaling im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So beschreiben Sie die verfügbaren Typen der Skalierungsanpassung

In diesem Beispiel werden die verfügbaren Anpassungstypen beschrieben.

aws autoscaling describe-adjustment-types

Ausgabe:

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

Weitere Informationen finden Sie unter Skalierungsanpassungstypen im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So beschreiben Sie die angegebene Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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": []
        }
    ]
}

Beispiel 2: So beschreiben Sie die ersten 100 angegebenen Auto-Scaling-Gruppen

In diesem Beispiel werden die angegebenen Auto-Scaling-Gruppen beschrieben. Sie können bis zu 100 Gruppennamen angeben.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Beispiel 3: So beschreiben Sie eine Auto-Scaling-Gruppe in der angegebenen Region

In diesem Beispiel werden die Auto-Scaling-Gruppen in der angegebenen Region beschrieben, wobei maximal 75 Gruppen berücksichtigt werden.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Beispiel 4: So beschreiben Sie die angegebene Anzahl von Auto-Scaling-Gruppen

Um eine bestimmte Anzahl von Auto-Scaling-Gruppen zurückzugeben, verwenden Sie die --max-items-Option.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere Gruppen. Um die zusätzlichen Gruppen abzurufen, verwenden Sie den Wert dieses Felds mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Beispiel 5: So beschreiben Sie Auto-Scaling-Gruppen, die Startkonfigurationen verwenden

Dieses Beispiel verwendet die --query-Option, um Auto-Scaling-Gruppen zu beschreiben, die Startkonfigurationen verwenden.

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

Ausgabe:

[
    {
        "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": []
    }
]

Weitere Informationen finden Sie unter Filtern der AWS-CLI-Ausgabe im Benutzerhandbuch der AWS-Befehlszeilenschnittstelle.

Beispiel 1: So beschreiben Sie eine oder mehrere Instances

In diesem Beispiel wird die angegebene Instance beschrieben.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

Beispiel 2: So beschreiben Sie eine oder mehrere Instances

Dieses Beispiel verwendet die --max-items-Option, um anzugeben, wie viele Instances mit diesem Aufruf zurückgegeben werden sollen.

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

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere Instances. Um die zusätzlichen Instances abzurufen, verwenden Sie den Wert dieses Felds mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Beispiel 3: So beschreiben Sie Instances, die Startkonfigurationen verwenden

In diesem Beispiel wird die --query-Option verwendet, um Instances zu beschreiben, die Startkonfigurationen verwenden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Filtern der AWS-CLI-Ausgabe im Benutzerhandbuch der AWS-Befehlszeilenschnittstelle.

So beschreiben Sie die verfügbaren Benachrichtigungstypen

In diesem Beispiel werden die verfügbaren Benachrichtigungstypen beschrieben.

aws autoscaling describe-auto-scaling-notification-types

Ausgabe:

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

Weitere Informationen finden Sie unter Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe im Amazon-EC2-Auto-Scaling-Benutzerhandbuch.

So beschreiben Sie Instance-Aktualisierungen

Im folgenden Beispiel für describe-instance-refreshes wird eine Beschreibung aller Instance-Aktualisierungsanforderungen für die angegebene Auto-Scaling-Gruppe zurückgegeben, einschließlich der Statusmeldung und (falls verfügbar) des Statusgrundes.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Überprüfen des Status einer Instance-Aktualisierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So beschreiben Sie die angegebene Startkonfiguration

In diesem Beispiel wird die angegebene Startkonfiguration beschrieben.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

Beispiel 2: So beschreiben Sie eine bestimmte Anzahl von Startkonfigurationen

Verwenden Sie die --max-items-Option, um eine bestimmte Anzahl von Startkonfigurationen zurückzugeben.

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

Wenn die Ausgabe ein NextToken-Feld enthält, stehen weitere Startkonfigurationen zur Verfügung. Um die zusätzlichen Startkonfigurationen abzurufen, verwenden Sie den Wert dieses Feldes mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt.

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

So beschreiben Sie die verfügbaren Typen von Lebenszyklus-Hooks

In diesem Beispiel werden die verfügbaren Typen von Lebenszyklus-Hooks beschrieben.

aws autoscaling describe-lifecycle-hook-types

Ausgabe:

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

So beschreiben Sie Ihre Lebenszyklus-Hooks

In diesem Beispiel werden die Lebenszyklus-Hooks für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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"
        }
    ]
}

So beschreiben Sie die Load-Balancer-Zielgruppen für eine Auto-Scaling-Gruppe

In diesem Beispiel werden die Load-Balancer-Zielgruppen beschrieben, die der angegebenen Auto-Scaling-Gruppe angehängt sind.

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

Ausgabe:

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

So beschreiben Sie die Classic Load Balancers für eine Auto-Scaling-Gruppe

In diesem Beispiel werden die Classic Load Balancers für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

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

So beschreiben Sie die verfügbaren Arten der Metrikerfassung

In diesem Beispiel werden die verfügbaren Arten der Metrikerfassung beschrieben.

aws autoscaling describe-metric-collection-types

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Auto-Scaling-Gruppen-Metriken im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So beschreiben Sie die Benachrichtigungskonfigurationen einer angegebenen Gruppe

In diesem Beispiel werden die Benachrichtigungskonfigurationen für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe im Amazon-EC2-Auto-Scaling-Benutzerhandbuch.

Beispiel 1: So beschreiben Sie eine bestimmte Anzahl von Benachrichtigungskonfigurationen

Verwenden Sie den max-items-Parameter, um eine bestimmte Anzahl von Benachrichtigungskonfigurationen zurückzugeben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere Benachrichtigungskonfigurationen. Verwenden Sie den Wert dieses Feldes mit dem starting-token-Parameter in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Benachrichtigungskonfigurationen zu erhalten.

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

Weitere Informationen finden Sie unter Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe im Amazon-EC2-Auto-Scaling-Benutzerhandbuch.

Beispiel 1: So beschreiben Sie die Skalierungsrichtlinien einer angegebenen Gruppe

In diesem Beispiel wird die Richtlinien für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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
        }
    ]
}

Weitere Informationen finden Sie unter Dynamische Skalierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So beschreiben Sie die Skalierungsrichtlinien eines bestimmten Namens

Verwenden Sie die --policy-names-Option, um bestimmte Skalierungsrichtlinien zurückzugeben.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Weitere Informationen finden Sie unter Dynamische Skalierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 3: So beschreiben Sie eine Reihe von Skalierungsrichtlinien

Verwenden Sie die --max-items-Option, um eine bestimmte Anzahl von Richtlinien zurückzugeben.

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

Eine Beispielausgabe finden Sie in Beispiel 1.

Wenn die Ausgabe ein NextToken-Feld enthält, verwenden Sie den Wert dieses Feldes mit der --starting-token-Option in einem nachfolgenden Aufruf, um die zusätzlichen Richtlinien abzurufen.

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

Weitere Informationen finden Sie unter Dynamische Skalierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So beschreiben Sie Skalierungsaktivitäten für die angegebene Gruppe

In diesem Beispiel werden die Skalierungsaktivitäten für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

Weitere Informationen finden Sie unter Verifizieren einer Skalierungsaktivität für eine Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So beschreiben Sie die Skalierungsaktivitäten für eine gelöschte Gruppe

Fügen Sie die --include-deleted-groups-Option hinzu, um Skalierungsaktivitäten nach dem Löschen der Auto-Scaling-Gruppe zu beschreiben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Fehlerbehebung bei Amazon EC2 Auto Scaling im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 3: So beschreiben Sie eine bestimmte Anzahl von Skalierungsaktivitäten

Verwenden Sie die --max-items-Option, um eine bestimmte Anzahl von Aktivitäten zurückzugeben.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere Aktivitäten. Verwenden Sie den Wert dieses Feldes mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Aktivitäten abzurufen.

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

Weitere Informationen finden Sie unter Verifizieren einer Skalierungsaktivität für eine Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So beschreiben Sie die verfügbaren Prozesstypen

In diesem Beispiel werden die verfügbaren Prozesstypen beschrieben.

aws autoscaling describe-scaling-process-types

Ausgabe:

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

Weitere Informationen finden Sie unter Aus- und Fortsetzen von Skalierungsprozessen im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So beschreiben Sie alle geplanten Aktionen

In diesem Beispiel werden alle Ihre geplanten Aktionen beschrieben.

aws autoscaling describe-scheduled-actions

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 2: So beschreiben Sie geplante Aktionen für die angegebene Gruppe

Verwenden Sie die --auto-scaling-group-name-Option, um die geplanten Aktionen für eine bestimmte Auto-Scaling-Gruppe zu beschreiben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 3: So beschreiben Sie die angegebene geplante Aktion

Verwenden Sie die --scheduled-action-names-Option, um eine bestimmte geplante Aktion zu beschreiben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 4: So beschreiben Sie geplante Aktionen mit einer bestimmten Startzeit

Verwenden Sie die --start-time-Option, um die geplanten Aktionen zu beschreiben, die zu einer bestimmten Zeit beginnen.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 5: So beschreiben Sie geplante Aktionen, die zu einem bestimmten Zeitpunkt enden

Verwenden Sie die --end-time-Option, um die geplanten Aktionen zu beschreiben, die zu einem bestimmten Zeitpunkt enden.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 6: So beschreiben Sie eine bestimmte Anzahl von geplanten Aktionen

Verwenden Sie die --max-items-Option, um eine bestimmte Anzahl von geplanten Aktionen zurückzugeben.

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

Ausgabe:

{
    "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"
        }
    ]
}

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere geplante Aktionen. Verwenden Sie den Wert dieses Feldes mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Aktivitäten abzurufen.

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

Weitere Informationen finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So beschreiben Sie alle Tags

In diesem Beispiel werden alle Ihre Tags beschrieben.

aws autoscaling describe-tags

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Markieren von Auto Scaling-Gruppen und Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 2: So beschreiben Sie Tags für eine bestimmte Gruppe

Verwenden Sie die --filters-Option, um Tags für eine bestimmte Auto-Scaling-Gruppe zu beschreiben.

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

Weitere Informationen finden Sie unter Markieren von Auto Scaling-Gruppen und Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 3: So beschreiben Sie die angegebene Anzahl von Tags

Verwenden Sie die --max-items-Option, um eine bestimmte Anzahl von Tags zurückzugeben.

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

Wenn die Ausgabe ein NextToken-Feld enthält, gibt es weitere Tags. Verwenden Sie den Wert dieses Feldes mit der --starting-token-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Tags zu erhalten.

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

Weitere Informationen finden Sie unter Markieren von Auto Scaling-Gruppen und Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So beschreiben Sie die verfügbaren Typen von Beendigungsrichtlinien

In diesem Beispiel werden die verfügbaren Arten von Beendigungsrichtlinien beschrieben.

aws autoscaling describe-termination-policy-types

Ausgabe:

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

Weitere Informationen finden Sie unter Steuern, welche Auto Scaling-Instances bei der horizontalen Skalierung nach unten beendet werden im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So beschreiben Sie einen warmen Pool

In diesem Beispiel wird der warme Pool für die angegebene Auto-Scaling-Gruppe beschrieben.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Warm-Pools für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So trennen Sie eine Instance von einer Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Instance von der angegebenen Auto-Scaling-Gruppe getrennt.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

So trennen Sie eine Load-Balancer-Zielgruppe von einer Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Load-Balancer-Zielgruppe von der spezifizierten Auto-Scaling-Gruppe getrennt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Anhängen eines Load Balancers an Ihre Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So trennen Sie einen Classic Load Balancer von einer Auto-Scaling-Gruppe

In diesem Beispiel wird der angegebene Classic Load Balancer von der spezifizierten Auto-Scaling-Gruppe getrennt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Anhängen eines Load Balancers an Ihre Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So deaktivieren Sie die Erfassung von Metriken für Auto-Scaling-Gruppen

In diesem Beispiel wird die Erfassung der GroupDesiredCapacity-Metrik für die angegebene Auto-Scaling-Gruppe deaktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Überwachung der CloudWatch-Metriken für Ihre Auto Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 1: So aktivieren Sie die Erfassung von Auto-Scaling-Gruppen

In diesem Beispiel wird die Datenerfassung für die angegebene Auto-Scaling-Gruppe aktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Überwachung der CloudWatch-Metriken für Ihre Auto Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 2: So sammeln Sie Daten für die angegebene Metrik einer Auto-Scaling-Gruppe

Verwenden Sie die --metrics-Option, um Daten für eine bestimmte Metrik zu sammeln.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Überwachung der CloudWatch-Metriken für Ihre Auto Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So verschieben Sie Instances in den Standby-Modus

In diesem Beispiel wird die angegebene Instance in den Standby-Modus versetzt. Das ist nützlich, um eine Instance zu aktualisieren oder Fehler zu beheben, die sich derzeit im Service befindet.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

Weitere Informationen finden Sie unter Instance-Lebenszyklus in Amazon EC2 Auto Scaling im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So führen Sie eine Skalierungsrichtlinie aus

In diesem Beispiel wird die Skalierungsrichtlinie mit dem Namen my-step-scale-out-policy für die angegebene Auto-Scaling-Gruppe ausgeführt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schrittweise und einfache Skalierungsrichtlinien im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So verschieben Sie Instances aus dem Standby-Modus

In diesem Beispiel wird die angegebenen Instance aus dem Standby-Modus verschoben.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

Weitere Informationen finden Sie unter Vorübergehendes Entfernen von Instances aus einer Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So erstellen Sie einen Lebenszyklus-Hook

In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der bei allen neu gestarteten Instances mit einem Timeout von 4800 Sekunden aufgerufen wird. Dies ist nützlich, um die Instances in einem Wartezustand zu halten, bis die Skripte der Benutzenden abgeschlossen sind, oder um eine AWS-Lambda-Funktion mithilfe von EventBridge aufzurufen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn ein Lebenszyklus-Hook mit demselben Namen bereits vorhanden ist, wird er durch den neuen Lebenszyklus-Hook überschrieben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 2: So senden Sie eine E-Mail-Nachricht in Amazon SNS, die Sie über den Statuswechsel einer Instance informiert

In diesem Beispiel wird ein Lebenszyklus-Hook mit dem Amazon-SNS-Thema und der IAM-Rolle erstellt, die zum Empfangen von Benachrichtigungen beim Instance-Start verwendet werden sollen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 3: So veröffentlichen Sie eine Nachricht in einer Amazon-SQS-Warteschlange

In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der eine Nachricht mit Metadaten in der angegebenen Amazon-SQS-Warteschlange veröffentlicht.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So fügen Sie eine neue Benachrichtigung hinzu

In diesem Beispiel wird die angegebene Benachrichtigung der spezifizierten Auto-Scaling-Gruppe hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe im Amazon-EC2-Auto-Scaling-Benutzerhandbuch.

So fügen Sie einer Auto-Scaling-Gruppe eine Richtlinie zur Zielverfolgung hinzu

Im folgenden put-scaling-policy-Beispiel wird eine Skalierungsrichtlinie zur Zielverfolgung auf die angegebene Auto-Scaling-Gruppe angewendet. Die Ausgabe enthält die ARNs und die Namen der beiden CloudWatch-Alarme, die für Sie erstellt wurden. Wenn bereits eine Skalierungsrichtlinie mit demselben Namen vorhanden ist, wird diese durch die neue Skalierungsrichtlinie überschrieben.

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

Inhalt von config.json:

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

Ausgabe:

{
     "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"
         }
     ]
 }

Weitere Beispiele finden Sie unter Beispiel für Skalierungsrichtlinien für AWS Command Line Interface (AWS CLI) im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 1: So fügen Sie einer Auto-Scaling-Gruppe eine geplante Aktion hinzu

In diesem Beispiel wird die angegebene geplante Aktion der angegebenen Auto-Scaling-Gruppe hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn eine geplante Aktion mit demselben Namen bereits vorhanden ist, wird sie durch die neue geplante Aktion überschrieben.

Weitere Informationen finden Sie unter Geplante Skalierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So geben Sie einen wiederkehrenden Zeitplan an

In diesem Beispiel wird eine geplante Aktion erstellt, die nach einem wiederkehrenden Zeitplan skaliert wird und jedes Jahr am 1. Januar, Juni und Dezember um 00:30 Uhr ausgeführt wird.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn eine geplante Aktion mit demselben Namen bereits vorhanden ist, wird sie durch die neue geplante Aktion überschrieben.

Weitere Informationen finden Sie unter Geplante Skalierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So erstellen Sie einen warmen Pool

Im folgenden Beispiel wird ein warmer Pool für die angegebene Auto-Scaling-Gruppe erstellt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn bereits ein warmer Pool vorhanden ist, wird dieser aktualisiert.

Weitere Informationen finden Sie unter Warm-Pools für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So zeichnen Sie den Heartbeat einer Lebenszyklusaktion auf

Dieses Beispiel zeichnet den Heartbeat für eine Lebenszyklusaktion auf, um die Instance im Status „Ausstehend“ zu halten.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Lebenszyklus-Hooks für Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So setzen Sie einen ausgesetzten Prozess fort

In diesem Beispiel wird der angegebene ausgesetzte Skalierungsprozess für die spezifizierte Auto-Scaling-Gruppe fortgesetzt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Aus- und Fortsetzen von Skalierungsprozessen im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So machen Sie eine Instance-Aktualisierung rückgängig

Im folgenden Beispiel für rollback-instance-refresh wird eine laufende Instance-Aktualisierung für die angegebene Auto-Scaling-Gruppe rückgängig gemacht.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Änderungen mit einem Rollback rückgängig machen im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So geben Sie die gewünschte Kapazität für die Auto-Scaling-Gruppe an

In diesem Beispiel wird die gewünschte Kapazität für die angegebene Auto-Scaling-Gruppe angegeben.

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

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

So geben Sie den Zustand einer Instance an

In diesem Beispiel wird der Zustand der angegebenen Instance auf Unhealthy gesetzt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 1: So ändern Sie die Instance-Schutzeinstellung für eine Instance

In diesem Beispiel wird der Instance-Schutz für die angegebene Instance aktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 2: So ändern Sie die Instance-Schutzeinstellung für eine Instance

In diesem Beispiel wird der Instance-Schutz für die angegebene Instance deaktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 1: So starten Sie eine Instance-Aktualisierung mithilfe von Befehlszeilenparametern

Im folgenden Beispiel für start-instance-refresh wird eine Instance-Aktualisierung mithilfe von Befehlszeilenargumenten gestartet. Der optionale Parameter preferences gibt ein InstanceWarmup von 60 Sekunden und einen MinHealthyPercentage von 50 Prozent an.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Starten einer Instance-Aktualisierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So starten Sie eine Instance-Aktualisierung mithilfe einer JSON-Datei

Im folgenden Beispiel für start-instance-refresh wird eine Instance-Aktualisierung mithilfe einer JSON-Datei gestartet. Sie können die Auto-Scaling-Gruppe angeben und Ihre gewünschte Konfiguration und bevorzugten Einstellungen in einer JSON-Datei definieren, wie im folgenden Beispiel gezeigt.

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

Inhalt von config.json:

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

Ausgabe:

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

Weitere Informationen finden Sie unter Starten einer Instance-Aktualisierung im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

So setzen Sie Auto-Scaling-Prozesse aus

In diesem Beispiel wird der angegebene Skalierungsprozess für die spezifizierte Auto-Scaling-Gruppe ausgesetzt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Aus- und Fortsetzen von Skalierungsprozessen im Amazon EC2 Auto Scaling-Benutzerhandbuch.

So beenden Sie eine Instance in einer Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Instance in der angegebenen Auto-Scaling-Gruppe beendet, ohne dass die Größe der Gruppe aktualisiert wird. Amazon EC2 Auto Scaling startet eine Ersatz-Instance, nachdem die angegebene Instance beendet wurde.

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

Ausgabe:

{
    "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\"}"
        }
    ]
}

Beispiel 1: So aktualisieren Sie die Größenbeschränkungen einer Auto-Scaling-Gruppe

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe mit einer Mindestgröße von 2 und einer Höchstgröße von 10 aktualisiert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Festlegen der Größenbeschränkungen für Ihre Auto-Scaling-Gruppe im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 2: So fügen Sie Zustandsprüfungen für Elastic Load Balancing hinzu und legen fest, welche Availability Zones und Subnetze verwendet werden sollen

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um Zustandsprüfungen für Elastic Load Balancing-hinzuzufügen. Dieser Befehl aktualisiert auch den Wert von --vpc-zone-identifier mit einer Liste von Subnetz-IDs in mehreren Availability Zones.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Elastic Load Balancing und Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling-Benutzerhandbuch.

Beispiel 3: So aktualisieren Sie die Platzierungsgruppe und die Beendigungsrichtlinie

In diesem Beispiel werden die zu verwendende Platzierungsgruppe und die Beendigungsrichtlinie aktualisiert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen zu Auto-Scaling-Gruppen finden Sie im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 4: So verwenden Sie die neueste Version der Startvorlage

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um die neueste Version der angegebenen Startvorlage zu verwenden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Startvorlagen im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 5: So verwenden Sie eine bestimmte Version der Startvorlage

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um eine bestimmte Version einer Startvorlage anstelle der neuesten oder der Standardversion zu verwenden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Startvorlagen im Benutzerhandbuch zu Amazon EC2 Auto Scaling.

Beispiel 6: So definieren Sie eine Richtlinie für gemischte Instances und aktivieren den Kapazitätsausgleich

In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um eine Richtlinie für gemischte Instances zu verwenden, gleichzeitig wird die Kapazitätsanpassung aktiviert. Mit dieser Struktur können Sie Gruppen mit Spot- und On-Demand-Kapazitäten angeben und verschiedene Startvorlagen für unterschiedliche Architekturen verwenden.

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

Inhalt von 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"
        }
    }
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Auto-Scaling-Gruppen mit mehreren Instance-Typen und Kaufoptionen im Amazon EC2 Auto Scaling-Benutzerhandbuch.