Verwendung der Kurzsyntax in der AWS CLI - AWS Command Line Interface

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Verwendung der Kurzsyntax in der AWS CLI

Die AWS Command Line Interface (AWS CLI) kann viele ihrer Optionsparameter im Format akzeptieren. JSON Es kann jedoch mühsam sein, große JSON Listen oder Strukturen in der Befehlszeile einzugeben. Um dies zu vereinfachen, unterstützt der AWS CLI auch eine Kurzsyntax, die eine einfachere Darstellung Ihrer Optionsparameter ermöglicht als die Verwendung des vollständigen Formats. JSON

Strukturparameter

Die Kurzsyntax in der AWS CLI erleichtert es Benutzern, Parameter einzugeben, die flach sind (nicht verschachtelte Strukturen). Das Format ist eine durch Kommata getrennte Liste von Schlüssel-Wert-Paaren. Verwenden Sie die geeigneten Anführungszeichen- und Escape-Zeichen-Regeln für Ihr Terminal, da es sich bei der Kurznotation um Zeichenfolgen handelt.

Linux or macOS
--option key1=value1,key2=value2,key3=value3
PowerShell
--option "key1=value1,key2=value2,key3=value3"

Beide entsprechen dem folgenden Beispiel, formatiert in. JSON

--option '{"key1":"value1","key2":"value2","key3":"value3"}'

Zwischen den einzelnen kommagetrennten Schlüssel-Wert-Paaren sind keine Leerzeichen erlaubt. Hier sehen Sie ein Beispiel für den update-table-Amazon-DynamoDB-Befehl mit der Option --provisioned-throughput in der Kurznotation.

$ aws dynamodb update-table \ --provisioned-throughput ReadCapacityUnits=15,WriteCapacityUnits=10 \ --table-name MyDDBTable

Dies entspricht dem folgenden Beispiel, formatiert in. JSON

$ aws dynamodb update-table \ --provisioned-throughput '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}' \ --table-name MyDDBTable

Verwenden Sie die Kurzsyntax mit dem AWS Command Line Interface

Sie können Eingabeparameter in Listenform auf zwei Arten angeben: oder in Kurzform. JSON Die Syntax-Kurznotation in der AWS CLI erleichtert die Eingabe von Listen mit Zahlen, Zeichenfolgen oder nicht geschachtelten Strukturen.

Das grundlegende Format wird hier dargestellt, wobei die Werte in der Liste durch ein einzelnes Leerzeichen voneinander getrennt sind.

--option value1 value2 value3

Dies entspricht dem folgenden Beispiel, formatiert in. JSON

--option '[value1,value2,value3]'

Wie bereits erwähnt, können Sie eine Liste von Zahlen, eine Liste mit Zeichenfolgen oder eine Liste nicht geschachtelter Strukturen in Kurznotation angeben. Im Folgenden finden Sie ein Beispiel für den stop-instances Befehl für Amazon Elastic Compute Cloud (AmazonEC2), bei dem der Eingabeparameter (Liste von Zeichenketten) für die --instance-ids Option in Kurzform angegeben wird.

$ aws ec2 stop-instances \ --instance-ids i-1486157a i-1286157c i-ec3a7e87

Dies entspricht dem folgenden Beispiel, das in formatiert ist. JSON

$ aws ec2 stop-instances \ --instance-ids '["i-1486157a","i-1286157c","i-ec3a7e87"]'

Das folgende Beispiel zeigt den EC2 create-tags Amazon-Befehl, der eine Liste von nicht verschachtelten Strukturen für die --tags Option verwendet. Die Option --resources gibt die ID der Instance an, die markiert werden soll.

$ aws ec2 create-tags \ --resources i-1286157c \ --tags Key=My1stTag,Value=Value1 Key=My2ndTag,Value=Value2 Key=My3rdTag,Value=Value3

Dies entspricht dem folgenden Beispiel, formatiert in. JSON Der JSON Parameter wird aus Gründen der Lesbarkeit über mehrere Zeilen geschrieben.

$ aws ec2 create-tags \ --resources i-1286157c \ --tags '[ {"Key": "My1stTag", "Value": "Value1"}, {"Key": "My2ndTag", "Value": "Value2"}, {"Key": "My3rdTag", "Value": "Value3"} ]'