Ändern eines Amazon-EC2-Instance-Typs mit einem Bash-Skript in der AWS CLI - AWS Command Line Interface
Bevor Sie beginnenÜber das BeispielParameterDateienReferenzen

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.

Ändern eines Amazon-EC2-Instance-Typs mit einem Bash-Skript in der AWS CLI

In diesem Beispiel zur Verwendung der Bash-Skriptsprache für Amazon EC2 wird der Typ einer Amazon-EC2-Instance mit der AWS Command Line Interface (AWS CLI) geändert. Dabei wird die Instance gestoppt, wenn sie ausgeführt wird, der Instance-Typ wird geändert und dann wird die Instance, falls angefordert, neu gestartet. Shell-Skripte sind Programme, die in einer Befehlszeilenschnittstelle ausgeführt werden sollen.

Anmerkung

Weitere Befehlsbeispiele finden Sie im AWS CLI-Referenzleitfaden.

Bevor Sie beginnen

Bevor Sie eines der folgenden Beispiele ausführen können, müssen die folgenden Schritte abgeschlossen werden.

  • Installieren und Konfigurieren der AWS CLI. Weitere Informationen finden Sie unter Installation oder Aktualisierung der neuesten Version von AWS CLI. und Authentifizierung und Anmeldeinformationen für die AWS CLI.

  • Das von Ihnen verwendete Profil muss über Berechtigungen verfügen, die die von den Beispielen ausgeführten AWS-Vorgänge zulassen.

  • Eine laufende Amazon-EC2-Instance in dem Konto, für das Sie die Berechtigung zum Beenden und Ändern haben. Wenn Sie das Testskript ausführen, startet es eine Instance, testet die Änderung des Typs und beendet dann die Instance.

  • Als bewährte AWS-Methode gewähren Sie diesem Code die geringsten Berechtigungen oder nur die Berechtigungen, die zum Ausführen einer Aufgabe erforderlich sind. Weitere Informationen finden Sie unter Gewähren der geringsten Berechtigung im AWS-Identity-and-Access-Management-(IAM)-Benutzerhandbuch.

  • Dieser Code wurde nicht in allen AWS-Regionen getestet. Einige AWS-Services werden nur in bestimmten Regionen angeboten. Weitere Informationen finden Sie unter Service-Endpunkte und Kontingente im allgemeinen AWS-Referenzhandbuch.

  • Durch die Ausführung dieses Codes können Kosten für Ihr AWS-Konto anfallen. Es liegt in Ihrer Verantwortung sicherzustellen, dass alle durch dieses Skript erstellten Ressourcen entfernt werden, wenn Sie mit ihnen fertig sind.

Über das Beispiel

Dieses Beispiel ist als Funktion in der Shell-Skriptdatei change_ec2_instance_type.sh geschrieben, die Sie von einem anderen Skript oder von der Befehlszeile aus source können. Jede Skriptdatei enthält Kommentare, die jede der Funktionen beschreiben. Sobald sich die Funktion im Speicher befindet, können Sie sie über die Befehlszeile aufrufen. Mit den folgenden Befehlen wird beispielsweise der Typ der angegebenen Instance in t2.nano geändert:

$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type

Das vollständige Beispiel und die herunterladbaren Skriptdateien finden Sie unter Ändern des Instance-Typs für Amazon-EC2 im AWS-Codebeispiel-Repository auf GitHub.

Parameter

-i – (String) Gibt die zu ändernde Instance-ID an.

-t – (String) Gibt den Instance-Typ von Amazon-EC2 an, zu dem gewechselt werden soll.

-r – (Switch) Ist standardmäßig nicht festgelegt. Wenn -r festgelegt ist, startet die Instance nach dem Typwechsel neu.

-f – (Switch) Standardmäßig fordert das Skript den Benutzer auf, das Herunterfahren der Instance zu bestätigen, bevor der Wechsel vorgenommen wird. Wenn -f festgelegt ist, wird der Benutzer nicht aufgefordert, das Herunterfahren der Instance zu bestätigen, bevor der Typwechsel vorgenommen wird.

-V – (Switch) Standardmäßig arbeitet das Skript im Hintergrund und zeigt die Ausgabe nur im Fehlerfall an. Wenn -v festgelegt ist, zeigt die Funktion während der gesamten Ausführungszeit den Status an.

Dateien

change_ec2_instance_type.sh

Die Hauptskriptdatei enthält die change_ec2_instance_type()-Funktion, die die folgenden Aufgaben ausführt:

  • Prüft, ob die angegebene Amazon-EC2-Instance vorhanden ist.

  • Warnt den Benutzer, bevor die Instance gestoppt wird, sofern -f nicht ausgewählt ist.

  • Ändert den Instance-Typ

  • Wenn Sie -r festlegen, wird die Instance neu gestartet und bestätigt, dass die Instance ausgeführt wird

Sehen Sie sich den Code für change_ec2_instance_type.sh in GitHub an.

test_change_ec2_instance_type.sh

Das test_change_ec2_instance_type.sh-Dateiskript testet die verschiedenen Codepfade für die change_ec2_instance_type-Funktion. Wenn alle Schritte im Testskript ordnungsgemäß funktionieren, entfernt das Testskript alle von ihm erstellten Ressourcen.

Sie können das Testskript mit den folgenden Parametern ausführen:

  • -V – (Switch) Die einzelnen Tests zeigen einen erfolgreichen/fehlgeschlagenen Status, während sie ausgeführt werden. Standardmäßig werden die Tests im Hintergrund ausgeführt und die Ausgabe enthält nur den endgültigen Gesamtstatus für erfolgreich/fehlgeschlagen.

  • -i – (Schalter) Das Skript wird nach jedem Test angehalten, damit Sie die Zwischenergebnisse jedes Schritts durchsuchen können. Mit dieser Option können Sie den aktuellen Status der Instance mit der Amazon-EC2-Konsole überprüfen. Das Skript fährt mit dem nächsten Schritt fort, nachdem Sie an der Eingabeaufforderung die EINGABETASTE gedrückt haben.

Sehen Sie sich den Code für test_change_ec2_instance_type.sh in GitHub an.

awsdocs_general.sh

Die Skriptdatei awsdocs_general.sh enthält allgemeine Funktionen, die in erweiterten Beispielen für die AWS CLI verwendet werden.

Sehen Sie sich den Code für awsdocs_general.sh in GitHub an.

Referenzen

AWS CLI-Referenz:

Andere Referenz: