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.

Allgemeine Parametertypen in der AWS CLI

In diesem Abschnitt werden einige häufige Parametertypen sowie das in der Regel erforderliche Format beschrieben.

Wenn Sie Probleme mit der Formatierung eines Parameters für einen bestimmten Befehl haben, sehen Sie in der Hilfe nach, indem Sie nach dem Befehlsnamen help eingeben. Die Hilfe für jeden Unterbefehl enthält den Namen und die Beschreibung einer Option. Der Parametertyp der Option ist in Klammern angegeben. Weitere Informationen zur Anzeige der Hilfe finden Sie unter Zugriff auf Hilfe und Ressourcen für die AWS CLI.

String

Zeichenkettenparameter können alphanumerische Zeichen, Symbole und Leerzeichen aus dem ASCIIZeichensatz enthalten. Zeichenfolgen, die Leerzeichen enthalten, müssen in Anführungszeichen gesetzt werden. Wir empfehlen, keine anderen Symbole oder Leerzeichen als das Standardleerzeichen zu verwenden und die Anführungszeichenregeln Ihres Terminals zu beachten, um unerwartete Ergebnisse zu vermeiden.

Einige Zeichenfolgenparameter können Binärdaten aus einer Datei akzeptieren. Ein Beispiel finden Sie unter Binärdateien.

Zeitstempel

Zeitstempel werden gemäß dem 8601-Standard formatiert. ISO Diese werden oft als „DateTime“- oder „Date“-Parameter bezeichnet.

$ aws ec2 describe-spot-price-history --start-time 2014-10-13T19:00:00Z

Zu den akzeptierte Formaten zählen folgende:

Sie können das Zeitstempelformat über die cli_timestamp_format-Dateieinstellung festlegen.

Auflisten

Eine oder mehrere durch Leerzeichen voneinander getrennte Zeichenfolgen. Wenn eines der Zeichenfolgenelemente ein Leerzeichen enthält, müssen Sie es in Anführungszeichen setzen. Beachten Sie die Anführungszeichenregeln Ihres Terminals, um unerwartete Ergebnisse zu vermeiden

$ aws ec2 describe-spot-price-history --instance-types m1.xlarge m1.medium

Boolesch

Binäres Flag, das eine Option aktiviert oder deaktiviert. Zum Beispiel verfügt ec2 describe-spot-price-history über einen booleschen Parameter --dry-run. Wenn dieser angegeben wird, verifiziert er die Abfrage mit dem Service, ohne tatsächlich die Abfrage auszuführen.

$ aws ec2 describe-spot-price-history --dry-run

Die Ausgabe gibt an, ob der Befehl ordnungsgemäß formatiert wurde oder nicht. Dieser Befehl enthält auch eine Version des Parameters --no-dry-run, mit dem Sie explizit angeben können, dass der Befehl normal ausgeführt werden soll. Dies ist allerdings nicht erforderlich, da dies das Standardverhalten ist.

Ganzzahl

Eine nicht signierte ganze Zahl.

$ aws ec2 describe-spot-price-history --max-items 5

Binary/Blob (Binary Large Object) und Streaming-Blob

In der AWS CLI können Sie einen Binärwert als Zeichenfolge direkt in der Befehlszeile übergeben. Es gibt zwei Arten von Blobs:

Blob

Um einen Wert an einen Parameter vom Typ blob zu übergeben, müssen Sie unter Verwendung des Präfix fileb:// einen Pfad zu einer lokalen Datei angeben, die die Binärdaten enthält. Dateien, auf die mit dem Präfix fileb:// verwiesen wird, werden immer als unkodierte Binärdateien behandelt. Der angegebene Pfad wird als relativ zum aktuellen Arbeitsverzeichnis interpretiert. Beispiel: Der Parameter --plaintext für aws kms encrypt ist ein Blob.

$ aws kms encrypt \
    --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
    --plaintext fileb://ExamplePlaintextFile \
    --output text \
    --query CiphertextBlob | base64 \
    --decode > ExampleEncryptedFile

Streaming-Blob

Streaming-Blobs wie z. B. aws cloudsearchdomain upload-documents verwenden keine Präfixe. Stattdessen werden Streaming-Blob-Parameter unter Verwendung des direkten Dateipfads formatiert. Im folgenden Beispiel wird der direkte Dateipfad document-batch.json für den Befehl aws cloudsearchdomain upload-documents verwendet:

$ aws cloudsearchdomain upload-documents \
    --endpoint-url https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com \
    --content-type application/json \
    --documents document-batch.json

Zuordnung

Ein Satz von Schlüssel-Wert-Paaren, die in JSON oder unter Verwendung der CLI Kurzsyntax von angegeben werden. Das folgende JSON Beispiel liest ein Element aus einer Amazon DynamoDB-Tabelle namens my-table mit einem Map-Parameter,. --key Der Parameter spezifiziert den Primärschlüssel mit dem Namen id mit einem Zahlenwert von 1 in einer verschachtelten Struktur. JSON

Für eine fortgeschrittenere JSON Verwendung in einer Befehlszeile sollten Sie erwägen, einen JSON Befehlszeilenprozessor zu verwendenjq, z. B. um JSON Zeichenketten zu erstellen. Weitere Informationen dazu jq finden Sie im jq-Repository unter GitHub.

$ aws dynamodb get-item --table-name my-table --key '{"id": {"N":"1"}}'

{
    "Item": {
        "name": {
            "S": "John"
        },
        "id": {
            "N": "1"
        }
    }
}

Dokument

Dokumenttypen werden verwendet, um Daten zu senden, ohne dass sie in Zeichenketten JSON eingebettet werden müssen. Der Dokumenttyp ermöglicht Services, willkürliche Schemata bereitzustellen, damit Sie flexiblere Datentypen verwenden können.

Dies ermöglicht das Senden von JSON Daten, ohne dass Werte maskiert werden müssen. Anstatt beispielsweise die folgende JSON Escape-Eingabe zu verwenden:

{"document": "{\"key\":true}"}

Können Sie den folgenden Dokumenttyp verwenden:

{"document": {"key": true}}

Gültige Werte für Dokumenttypen

Aufgrund der flexiblen Natur von Dokumenttypen gibt es mehrere gültige Werttypen. Gültige Werte sind unter anderem: