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 format JSON. Toutefois, il peut être fastidieux de saisir de longues listes ou structures JSON 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 JSON complet.

Paramètres de structure avec paires clé-valeur

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.

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

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

Chargement d'un fichier en tant que valeur de syntaxe abrégée

Lorsqu'une valeur est grande ou complexe, il est souvent plus facile de la charger en tant que valeur. Pour charger un fichier en tant que valeur de syntaxe abrégée, le formatage changera légèrement. Au lieu de cela, key=value vous utiliserez l'@=opérateur au lieu de l'=opérateur. Cela @= signifie AWS CLI que la valeur doit être lue comme un chemin de fichier et non comme une chaîne. Lorsque vous chargez des fichiers en syntaxe abrégée, les règles habituelles de formatage des AWS CLI fichiers s'appliquent. L'exemple suivant montre une paire clé-valeur chargeant un fichier pour sa valeur.

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

L'exemple suivant montre comment charger un fichier de certificat pour la aws rolesanywhere create-trust-anchor commande.

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

En utilisant une syntaxe abrégée avec AWS CLI

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

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

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