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.

Verwenden der Kurznotationssyntax in der AWS CLI

Die AWS Command Line Interface (AWS CLI) kann viele ihrer Optionsparameter im JSON-Format akzeptieren. Allerdings ist es mühsam, große JSON-Listen oder -Strukturen in die Befehlszeile einzugeben. Um dies zu vereinfachen, unterstützt die AWS CLI auch eine Syntax-Kurznotation, mit der Sie die Optionsparameter einfacher als im vollständigen JSON-Format darstellen können.

Strukturparameter mit Schlüssel-Wert-Paaren

Mit der Kurznotation in der AWS CLI können die Benutzer flache Parameter (nicht geschachtelte Strukturen) einfacher eingeben. 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

Entspricht dem unten stehenden JSON-formatierten Beispiel.

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

Windows

--option "key1=value1,key2=value2,key3=value3"

Entspricht dem unten stehenden JSON-formatierten Beispiel.

--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 unten stehenden JSON-formatierten Beispiel.

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

Laden einer Datei als Kurznotationssyntax-Wert

Bei großen oder komplexen Werten ist es oft einfacher, eine Datei als Wert zu laden. Um eine Datei als Kurznotationssyntax-Wert zu laden, ändert sich die Formatierung geringfügig. Statt key=value verwenden Sie den Operator @= anstelle des Operators =. @= weist die AWS CLI darauf hin, dass der Wert als Dateipfad und nicht als Zeichenfolge gelesen werden soll. Beim Laden von Dateien in Kurznotationssyntax gelten die üblichen AWS CLI-Dateiformatierungsregeln. Das folgende Beispiel zeigt ein Schlüssel-Wert-Paar, das eine Datei für seinen Wert lädt.

Linux or macOS

--option key@=file://template.txt

Windows

--option "key1@=file://template.txt"

Das folgende Beispiel zeigt, wie eine Zertifikatsdatei für den Befehl aws rolesanywhere create-trust-anchor geladen wird.

$ aws rolesanywhere create-trust-anchor --name TrustAnchor \
    --source sourceData={x509CertificateData@=file://root-ca.crt},sourceType="CERTIFICATE_BUNDLE"  \ 
    --enabled

Verwenden der Kurznotation mit der AWS CLI

Sie können Eingabeparameter in einem Listenformular auf zwei verschiedene Arten angeben: JSON und Kurznotation. 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 unten stehenden JSON-formatierten Beispiel.

--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. Das folgende Beispiel zeigt den Befehl stop-instances für Amazon Elastic Compute Cloud (Amazon EC2), wobei die Eingabeparameter (Liste aus Zeichenfolgen) für die Option --instance-ids in Kurznotation angegeben sind.

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

Dies entspricht dem unten stehenden JSON-formatierten Beispiel.

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

Das folgende Beispiel zeigt den create-tags-Befehl von Amazon EC2, der eine Liste nicht geschachtelter Strukturen für die Option --tags erwartet. 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 unten stehenden JSON-formatierten Beispiel. Der JSON-Parameter ist für eine bessere Lesbarkeit auf mehrere Zeilen verteilt.

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