Utilizzo della sintassi abbreviata in AWS CLI

Il AWS Command Line Interface (AWS CLI) può accettare molti dei suoi parametri di opzione in formato JSON. Tuttavia, può essere noioso immettere lunghi elenchi o strutture JSON nella riga di comando. Per semplificare questa operazione, supporta AWS CLI anche una sintassi abbreviata che consente una rappresentazione più semplice dei parametri delle opzioni rispetto all'utilizzo del formato JSON completo.

Struttura i parametri con coppie chiave-valore

La sintassi abbreviata di AWS CLI semplifica l'immissione di parametri piatti (strutture non annidate) da parte degli utenti. Il formato è un elenco separato da virgole di coppie chiave-valore. Assicuratevi di utilizzare le regole di quotazione ed escape appropriate per il vostro terminale, poiché la sintassi abbreviata è costituita da stringhe.

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

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

Le coppie chiave-valore separate da virgole non devono contenere spazi vuoti. Ecco un esempio del comando Amazon DynamoDB con l'opzione update-table specificata in forma --provisioned-throughput abbreviata.

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

È l'equivalente dell'esempio seguente in formato JSON.

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

Caricamento di un file come valore di sintassi abbreviata

Quando un valore è grande o complesso, è spesso più facile caricarlo come valore. Per caricare un file come valore di sintassi abbreviata, la formattazione cambierà leggermente. Invece, key=value utilizzerai l'operatore al posto dell'@=operatore. = @=Significa AWS CLI che il valore deve essere letto come un percorso di file e non come una stringa. Quando si caricano file in sintassi abbreviata, si applicano le normali regole di formattazione dei AWS CLI file. L'esempio seguente mostra una coppia chiave-valore che carica un file in base al relativo valore.

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

L'esempio seguente mostra il caricamento di un file di certificato per il comando. aws rolesanywhere create-trust-anchor

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

Utilizzo della sintassi abbreviata con AWS CLI

Puoi specificare i parametri di input in formato elenco in due modi: JSON o abbreviato. La sintassi abbreviata di AWS CLI è stata progettata per rendere più facile il trasferimento di elenchi di numeri, di stringhe o di strutture non nidificate.

Qui viene mostrato il formato di base,in cui i valori nell'elenco sono separati da un solo spazio.

--option value1 value2 value3

È l'equivalente dell'esempio seguente in formato JSON.

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

Come accennato in precedenza, è possibile specificare un elenco di numeri, un elenco di stringhe o un elenco di strutture non nidificate in forato abbreviato. Di seguito è riportato un esempio del stop-instances comando per Amazon Elastic Compute Cloud (Amazon EC2), in cui il parametro di input (elenco di stringhe) per l'--instance-idsopzione è specificato in forma abbreviata.

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

È l'equivalente dell'esempio seguente in formato JSON.

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

L'esempio seguente mostra il EC2 create-tags comando Amazon, che richiede un elenco di strutture non annidate per l'--tagsopzione. L'opzione --resources specifica l'ID dell'istanza da contrassegnare.

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

È l'equivalente dell'esempio seguente in formato JSON. Il parametro JSON viene scritto su più righe per maggiore leggibilità.

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