Auto Scaling Scaling-Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Auto Scaling Scaling-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Auto Scaling Aktionen ausführen und allgemeine Szenarien implementieren.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie Sieattach-instances.

AWS CLI

So fügen Sie einer Auto-Scaling-Gruppe eine Instance 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.

  • Einzelheiten zur API finden Sie AttachInstancesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungattach-load-balancer-target-groups.

AWS CLI

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 Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungattach-load-balancers.

AWS CLI

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 Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcancel-instance-refresh.

AWS CLI

Um eine Instanzaktualisierung abzubrechen

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcomplete-lifecycle-action.

AWS CLI

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 der Start oder das 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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-auto-scaling-group.

AWS CLI

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

Das folgende Beispiel für create-auto-scaling-group 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 finden Sie unter Auto Scaling Scaling-Gruppen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 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 EC2 Amazon-Benutzerhandbuch für 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 finden Sie unter Auto Scaling Scaling-Gruppen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Scaling-Kündigungsrichtlinien im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling 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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Beispiel 8: So geben Sie eine benutzerdefinierte Beendigungsrichtlinie an

In diesem Beispiel wird eine Auto Scaling-Gruppe erstellt, die eine benutzerdefinierte Richtlinie zur Beendigung von Lambda-Funktionen spezifiziert, die Amazon EC2 Auto Scaling mitteilt, welche Instances sicher im großen Maßstab 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 Kündigungsrichtlinie mit Lambda im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-launch-configuration.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 EC2 Amazon-Instances ausgeführt werden, im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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

In diesem Beispiel wird eine Startkonfiguration mit aktivierter EC2 detaillierter Überwachung erstellt, an die EC2 Metriken CloudWatch in Zeitabständen von 1 Minute gesendet werden.

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 Konfiguration der Überwachung für Auto Scaling Scaling-Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Spot-Instances anfordern im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Beispiel 6: So erstellen Sie eine Startkonfiguration mithilfe 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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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-EBSgp3-Volume 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 Amazon EC2 Auto Scaling API-Referenz.

Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch für die 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 BlockDeviceMappingin der Amazon EC2 Auto Scaling API-Referenz.

Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch für die 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-Zuweisung 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 BlockDeviceMappingin der Amazon EC2 Auto Scaling API-Referenz.

Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendungcreate-or-update-tags.

AWS CLI

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 Tagging Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-auto-scaling-group.

AWS CLI

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 Ihrer Auto Scaling Scaling-Infrastruktur im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Ihrer Auto Scaling Scaling-Infrastruktur im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-launch-configuration.

AWS CLI

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 Ihrer Auto Scaling Scaling-Infrastruktur im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-lifecycle-hook.

AWS CLI

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.

Das folgende Codebeispiel zeigt die Verwendungdelete-notification-configuration.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-policy.

AWS CLI

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.

  • Einzelheiten zur API finden Sie DeletePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-scheduled-action.

AWS CLI

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.

Das folgende Codebeispiel zeigt die Verwendungdelete-tags.

AWS CLI

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

In diesem Beispiel wird das angegebene Tag aus der spezifizierten 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 Tagging Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteTagsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-warm-pool.

AWS CLI

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 for Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling 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 for Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteWarmPoolin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-account-limits.

AWS CLI

Um Ihre Amazon EC2 Auto Scaling Scaling-Kontolimits zu beschreiben

In diesem Beispiel werden die Amazon EC2 Auto Scaling Scaling-Limits 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 Amazon EC2 Auto Scaling-Servicekontingente im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-adjustment-types.

AWS CLI

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 Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-auto-scaling-groups.

AWS CLI

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 AWS CLI-Ausgabe filtern im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendungdescribe-auto-scaling-instances.

AWS CLI

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 AWS CLI-Ausgabe filtern im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendungdescribe-auto-scaling-notification-types.

AWS CLI

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 Amazon SNS-Benachrichtigungen erhalten, wenn Ihre Auto Scaling-Gruppe skaliert wird im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-instance-refreshes.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-launch-configurations.

AWS CLI

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-lifecycle-hook-types.

AWS CLI

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-lifecycle-hooks.

AWS CLI

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-load-balancer-target-groups.

AWS CLI

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-load-balancers.

AWS CLI

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-metric-collection-types.

AWS CLI

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 Scaling-Gruppenmetriken im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-notification-configurations.

AWS CLI

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 Amazon SNS-Benachrichtigungen erhalten, wenn Ihre Auto Scaling-Gruppe skaliert wird im Amazon EC2 Auto Scaling 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 Amazon SNS-Benachrichtigungen erhalten, wenn Ihre Auto Scaling-Gruppe skaliert wird im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-policies.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DescribePoliciesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-scaling-activities.

AWS CLI

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 Überprüfen einer Skalierungsaktivität für eine Auto Scaling Scaling-Gruppe im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Problembehandlung bei Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Überprüfen einer Skalierungsaktivität für eine Auto Scaling Scaling-Gruppe im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-scaling-process-types.

AWS CLI

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 Aussetzen und Wiederaufnehmen von Skalierungsprozessen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-scheduled-actions.

AWS CLI

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 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 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 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 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 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 Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-tags.

AWS CLI

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 Tagging Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling 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 Tagging Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling 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 Tagging Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DescribeTagsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-termination-policy-types.

AWS CLI

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 während der Skalierung beendet werden im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-warm-pool.

AWS CLI

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 for Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DescribeWarmPoolin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdetach-instances.

AWS CLI

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

  • Einzelheiten zur API finden Sie DetachInstancesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdetach-load-balancer-target-groups.

AWS CLI

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 Einen Load Balancer zu Ihrer Auto Scaling Scaling-Gruppe hinzufügen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdetach-load-balancers.

AWS CLI

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 Einen Load Balancer zu Ihrer Auto Scaling Scaling-Gruppe hinzufügen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdisable-metrics-collection.

AWS CLI

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 CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungenable-metrics-collection.

AWS CLI

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 CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling 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 CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungenter-standby.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Instance-Lebenszyklus im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie EnterStandbyunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungexecute-policy.

AWS CLI

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 Step and Simple Scaling Policies im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ExecutePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungexit-standby.

AWS CLI

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 Ihrer Auto Scaling Scaling-Gruppe im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ExitStandbyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-lifecycle-hook.

AWS CLI

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 4 800 Sekunden aufgerufen wird. Dies ist nützlich, um die Instanzen im Wartezustand zu halten, bis die Benutzerdatenskripts abgeschlossen sind, oder um eine AWS Lambda-Funktion mit aufzurufen. 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

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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling 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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling 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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutLifecycleHookin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-notification-configuration.

AWS CLI

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 Amazon SNS-Benachrichtigungen erhalten, wenn Ihre Auto Scaling-Gruppe skaliert wird im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-scaling-policy.

AWS CLI

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

Im folgenden Beispiel für put-scaling-policy wird eine Skalierungsrichtlinie zur Zielverfolgung auf die angegebene Auto-Scaling-Gruppe angewendet. Die Ausgabe enthält die Namen ARNs und der beiden CloudWatch Alarme, die in Ihrem Namen 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 die AWS Befehlszeilenschnittstelle (AWS CLI) im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutScalingPolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-scheduled-update-group-action.

AWS CLI

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 Beispiele finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Beispiele finden Sie unter Geplante Skalierung im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-warm-pool.

AWS CLI

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 for Amazon EC2 Auto Scaling im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutWarmPoolin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrecord-lifecycle-action-heartbeat.

AWS CLI

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 Amazon EC2 Auto Scaling Lifecycle Hooks im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungresume-processes.

AWS CLI

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 Aussetzen und Wiederaufnehmen von Skalierungsprozessen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ResumeProcessesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungrollback-instance-refresh.

AWS CLI

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 Rückgängigmachen von Änderungen mit einem Rollback im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungset-desired-capacity.

AWS CLI

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 zum Prompt zurück.

Das folgende Codebeispiel zeigt die Verwendungset-instance-health.

AWS CLI

So geben Sie den Zustand einer Instance an

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

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungset-instance-protection.

AWS CLI

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.

Das folgende Codebeispiel zeigt die Verwendungstart-instance-refresh.

AWS CLI

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungsuspend-processes.

AWS CLI

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 Aussetzen und Wiederaufnehmen von Skalierungsprozessen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie SuspendProcessesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungterminate-instance-in-auto-scaling-group.

AWS CLI

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

In diesem Beispiel wird die angegebene Instance in der spezifizierten 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\"}"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungupdate-auto-scaling-group.

AWS CLI

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 von Kapazitätsgrenzen für Ihre Auto Scaling Scaling-Gruppe im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 den Wert von auch --vpc-zone-identifier mit einer Liste von Subnetzen 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 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 finden Sie unter Auto Scaling Scaling-Gruppen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Vorlagen starten im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Vorlagen starten im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

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 Scaling-Gruppen mit mehreren Instance-Typen und Kaufoptionen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.