Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan sintaks singkatan di AWS CLI

The AWS Command Line Interface (AWS CLI) dapat menerima banyak parameter opsinya dalam format JSON. Namun, bisa membosankan untuk memasukkan daftar atau struktur JSON besar pada baris perintah. Untuk membuat ini lebih mudah, AWS CLI juga mendukung sintaks singkatan yang memungkinkan representasi yang lebih sederhana dari parameter opsi Anda daripada menggunakan format JSON lengkap.

Parameter struktur dengan pasangan kunci-nilai

Sintaks singkatan dalam AWS CLI memudahkan pengguna untuk memasukkan parameter yang datar (struktur non-bersarang). Formatnya adalah daftar pasangan kunci-nilai yang dipisahkan koma. Pastikan untuk menggunakan aturan kutipan dan escaping yang sesuai untuk terminal Anda karena sintaks singkatan adalah string.

Linux or macOS

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

Setara dengan contoh berikut, diformat dalam JSON.

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

Windows

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

Setara dengan contoh berikut, diformat dalam JSON.

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

Tidak boleh ada spasi putih di antara setiap pasangan nilai kunci yang dipisahkan koma. Berikut adalah contoh perintah Amazon update-table DynamoDB dengan opsi yang ditentukan --provisioned-throughput dalam singkatan.

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

Ini setara dengan contoh berikut yang diformat dalam JSON.

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

Memuat file sebagai nilai sintaks singkatan

Ketika suatu nilai besar atau kompleks, seringkali lebih mudah untuk memuat sebagai nilai. Untuk memuat file sebagai nilai sintaks singkatan, pemformatan akan sedikit berubah. Alih-alih key=value Anda akan menggunakan @= operator alih-alih = operator. @=Menandakan AWS CLI bahwa nilai harus dibaca sebagai jalur file dan bukan string. Saat memuat file dalam sintaks singkatan, aturan pemformatan AWS CLI file yang biasa berlaku. Contoh berikut menunjukkan pasangan kunci-nilai memuat file untuk nilainya.

Linux or macOS

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

Windows

--option "key1@=file://template.txt"

Contoh berikut menunjukkan memuat file sertifikat untuk aws rolesanywhere create-trust-anchor perintah.

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

Menggunakan sintaks singkatan dengan AWS CLI

Anda dapat menentukan parameter Input dalam formulir daftar dengan dua cara: JSON atau singkatan. Sintaks AWS CLI singkatan dirancang untuk membuatnya lebih mudah untuk meneruskan daftar dengan angka, string, atau struktur non-bersarang.

Format dasar ditampilkan di sini, di mana nilai-nilai dalam daftar dipisahkan oleh satu spasi.

--option value1 value2 value3

Ini setara dengan contoh berikut, diformat dalam JSON.

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

Seperti disebutkan sebelumnya, Anda dapat menentukan daftar angka, daftar string, atau daftar struktur non-bersarang di singkatan. Berikut ini adalah contoh stop-instances perintah untuk Amazon Elastic Compute Cloud (Amazon EC2), di mana parameter input (daftar string) untuk --instance-ids opsi ditentukan dalam singkatan.

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

Ini setara dengan contoh berikut yang diformat dalam JSON.

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

Contoh berikut menunjukkan EC2 create-tags perintah Amazon, yang mengambil daftar struktur non-bersarang untuk opsi. --tags --resourcesPilihan menentukan ID dari contoh untuk tag.

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

Ini setara dengan contoh berikut, diformat dalam JSON. Parameter JSON ditulis di atas beberapa baris untuk keterbacaan.

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