Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

En utilisant la syntaxe abrégée dans le AWS CLI

Le AWS Command Line Interface (AWS CLI) peut accepter plusieurs de ses paramètres d'option au JSON format. Cependant, il peut être fastidieux de saisir de grandes JSON listes ou structures sur la ligne de commande. Pour vous faciliter la tâche, il prend AWS CLI également en charge une syntaxe abrégée qui permet une représentation plus simple des paramètres de vos options qu'en utilisant le format completJSON.

Paramètres de structure

La syntaxe abrégée utilisée dans le AWS CLI permet aux utilisateurs de saisir plus facilement des paramètres plats (structures non imbriquées). Le format est une liste séparée par des virgules des paires clé-valeur. Veillez à utiliser les règles de citation et d'échappement adaptées à votre terminal, car les syntaxes abrégées sont des chaînes.

Linux or macOS

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

PowerShell

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

Ils sont tous deux équivalents à l'exemple suivant, formatés au JSON format.

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

Il ne doit y avoir aucun espace entre chaque paire clé-valeur séparée par des virgules. Voici un exemple de commande Amazon update-table DynamoDB avec l'option spécifiée en --provisioned-throughput abrégé.

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

Ceci est équivalent à l'exemple suivant formaté enJSON.

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

En utilisant une syntaxe abrégée avec AWS Command Line Interface

Vous pouvez spécifier les paramètres d'entrée sous forme de liste de deux manières : JSON ou en abrégé. La syntaxe raccourcie de l' AWS CLI est conçue pour faciliter la transmission de listes comportant des nombres, des chaînes ou des structures non imbriquées.

Le format de base est illustré ici, avec les valeurs de la liste séparées par un espace simple.

--option value1 value2 value3

Ceci est équivalent à l'exemple suivant, formaté enJSON.

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

Comme indiqué plus haut, vous pouvez utiliser une syntaxe raccourcie pour indiquer une liste de nombres, une liste de chaînes ou une liste de structures non imbriquées. Voici un exemple de stop-instances commande pour Amazon Elastic Compute Cloud (AmazonEC2), où le paramètre d'entrée (liste de chaînes) de l'--instance-idsoption est spécifié sous forme abrégée.

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

Ceci est équivalent à l'exemple suivant formaté enJSON.

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

L'exemple suivant montre la EC2 create-tags commande Amazon, qui prend une liste de structures non imbriquées pour l'--tagsoption. L'option --resources spécifie l'ID de l'instance à baliser.

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

Ceci est équivalent à l'exemple suivant, formaté enJSON. Le JSON paramètre est écrit sur plusieurs lignes pour plus de lisibilité.

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