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.
Instances mit synchroner Bereitstellung werden gestartet
Sie können die LaunchInstances API verwenden, um synchron eine bestimmte Anzahl von Instances in Ihrer Auto Scaling Scaling-Gruppe zu starten. Die API startet Instances in der von Ihnen angegebenen Availability Zone oder dem Subnetz und gibt sofort die Instance- IDs oder Fehlerinformationen zurück.
Voraussetzungen
Bevor Sie die LaunchInstances API verwenden können, müssen Sie über Folgendes verfügen:
-
Eine Auto Scaling Scaling-Gruppe, die eine Startvorlage verwendet (Startkonfigurationen werden nicht unterstützt)
-
Sie benötigen Berechtigungen für die folgenden IAM-Aktionen:
-
autoscaling:LaunchInstances -
ec2:CreateFleet -
ec2:DescribeLaunchTemplateVersions
-
Starten Sie Instances mit synchroner Bereitstellung
Sie können Instances mit synchroner Bereitstellung über den starten. AWS CLI
AWS CLI
So starten Sie Instances mit synchroner Bereitstellung:
aws autoscaling launch-instances \ --auto-scaling-group-namegroup-name\ --requested-capacitynumber\ [--availability-zoneszone-name] \ [--subnet-idssubnet-id] \ [--availability-zone-idszone-id] \ [--retry-strategynone|retry-with-group-configuration] \ [--client-tokentoken]
Beispiele
Instanzen in einer bestimmten Availability Zone starten
aws autoscaling launch-instances \ --auto-scaling-group-namemy-asg\ --requested-capacity3\ --availability-zonesus-east-1a\ --retry-strategyretry-with-group-configuration
Instances in einem bestimmten Subnetz starten
aws autoscaling launch-instances \ --auto-scaling-group-namemy-asg\ --requested-capacity2\ --subnet-idssubnet-12345678\ --retry-strategynone\ --client-tokenmy-unique-token-123
Umgang mit Antworten
Beispiel für eine erfolgreiche Antwort:
{ "AutoScalingGroupName": "my-asg", "ClientToken": "my-unique-token-123", "Instances": [ { "InstanceType": "m5.xlarge", "AvailabilityZone": "us-east-1a", "AvailabilityZoneId": "use1-az1", "SubnetId": "subnet-12345678", "MarketType": "OnDemand", "InstanceIds": ["i-0123456789abcdef0", "i-0fedcba9876543210"] } ], "Errors": [] }
Beispiel für eine Antwort mit Fehlern
{ "AutoScalingGroupName": "my-asg", "ClientToken": "my-unique-token-123", "Instances": [], "Errors": [ { "InstanceType": "m5.large", "AvailabilityZone": "us-east-1a", "AvailabilityZoneId": "use1-az1", "SubnetId": "subnet-12345678", "MarketType": "OnDemand", "ErrorCode": "InsufficientInstanceCapacity", "ErrorMessage": "There is not enough capacity to fulfill your request for instance type 'm5.large' in 'us-east-1a'" } ] }
Behandeln Sie Startfehler und Wiederholungsversuche
Wenn die LaunchInstances API auf Fehler stößt, können Sie Wiederholungsstrategien mithilfe von Idempotenz-Tokens und entsprechenden Wiederholungsrichtlinien implementieren.
Sie können den Parameter client-token verwenden, um Anfragen erneut zu versuchen. Sie können auch die folgenden Wiederholungsstrategien verwenden:
-
RetryStrategy: none(Standard) — Wenn der API-Aufruf fehlschlägt, bleibt die gewünschte Kapazität der Auto Scaling Scaling-Gruppe unverändert und es erfolgt kein automatischer Wiederholungsversuch. -
RetryStrategy: retry-with-group-configuration- Wenn der API-Aufruf fehlschlägt, wird die gewünschte Kapazität der Auto Scaling-Gruppe um den angeforderten Betrag erhöht, und Auto Scaling versucht automatisch erneut, Instances mit der Standardkonfiguration und den Standardprozessen der Gruppe zu starten.
Das Wiederholungsverhalten für RetryStrategy: retry-with-group-configuration hängt von der Art des Fehlers ab:
-
Validierungsfehler: Die gewünschte Kapazität wurde nicht erhöht, da der Vorgang nicht fortgesetzt werden kann. Zum Beispiel ungültige Parameter oder nicht unterstützte Konfigurationen.
-
Kapazitätsfehler: Die gewünschte Kapazität wird erhöht und Auto Scaling versucht erneut, Instances asynchron mit den normalen Skalierungsprozessen der Gruppe zu starten.
Verwendung von Client-Token zur Bekämpfung von Idempotenz
Der client-token Parameter gewährleistet idempotente Operationen und ermöglicht sichere Wiederholungen von Startanfragen.
Wichtigste Verhaltensweisen:
-
Client-Token haben eine Gültigkeitsdauer von 8 Stunden ab der ersten Anfrage
-
Bei einem erneuten Versuch mit demselben Client-Token innerhalb von 8 Stunden wird die zwischengespeicherte Antwort zurückgegeben, anstatt neue Instances zu starten
-
Nach 8 Stunden initiiert dasselbe Client-Token einen neuen Startvorgang