Utilisez une syntaxe abrégée avec AWS CLI

L'AWS Command Line Interface (AWS CLI) peut accepter un grand nombre de ses paramètres d'option au format JSON. Toutefois, il peut être fastidieux de saisir de longues listes ou structures JSON sur la ligne de commande. Pour faciliter cette tâche, l'AWS CLI accepte également une syntaxe raccourcie qui permet une représentation plus simple de vos paramètres d'option que l'utilisation du format JSON complet.

Paramètres de structure

La syntaxe raccourcie de l'AWS CLI simplifie pour les utilisateurs la saisie 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"

Celles-ci sont équivalentes à l'exemple suivant au format JSON.

--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

Cela équivaut à l'exemple suivant au format JSON.

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

Utilisation de la syntaxe raccourcie avec l'AWS Command Line Interface

Vous pouvez spécifier des paramètres d'entrée d'une liste peuvent être spécifiés de deux manières : JSON ou syntaxe raccourcie. 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

Cela équivaut à l'exemple suivant au format JSON.

--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 (Amazon EC2), dans lequel le paramètre d'entrée (liste de chaînes) de --instance-ids l'option est spécifié sous forme abrégée.

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

Cela équivaut à l'exemple suivant au format JSON.

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

L'exemple suivant montre la create-tags commande Amazon EC2, qui utilise une liste de structures non imbriquées pour l'option. --tags 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

Cela équivaut à l'exemple suivant au format JSON. Le paramètre JSON est écrit sur plusieurs lignes pour une meilleure lisibilité.

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