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

The AWS Command Line Interface (AWS CLI) kann viele seiner 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 der AWS CLI auch eine Kurzsyntax, die eine einfachere Darstellung Ihrer Optionsparameter ermöglicht als die Verwendung des vollständigen JSON-Formats.

Strukturieren Sie Parameter mit Schlüssel-Wert-Paaren

Die Kurzsyntax in der AWS CLI erleichtert Benutzern die Eingabe von flachen Parametern (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

Entspricht dem folgenden, in JSON formatierten Beispiel.

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

Windows

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

Entspricht dem folgenden, in 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

Eine Datei als Kurzsyntaxwert wird geladen

Wenn ein Wert groß oder komplex ist, ist es oft einfacher, ihn als Wert zu laden. Um eine Datei als Kurzsyntaxwert zu laden, ändert sich die Formatierung geringfügig. Stattdessen verwenden key=value Sie den @= Operator anstelle des Operators. = Das @= bedeutet für sie, AWS CLI dass der Wert als Dateipfad und nicht als Zeichenfolge gelesen werden soll. Beim Laden von Dateien in Kurzsyntax gelten die üblichen AWS CLI Dateiformatierungsregeln. Das folgende Beispiel zeigt ein Schlüssel-Wert-Paar, das eine Datei für ihren 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 aws rolesanywhere create-trust-anchor Befehl geladen wird.

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

Verwenden Sie die Kurzsyntax mit 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. Im Folgenden finden Sie ein Beispiel für den stop-instances Befehl für Amazon Elastic Compute Cloud (Amazon EC2), 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 unten stehenden JSON-formatierten Beispiel.

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