Alibaba Cloud CLI：Opsi baris perintah Alibaba Cloud CLI

Opsi

Deskripsi

--profile,-p

Anda dapat menggunakan opsi --profile atau -p untuk menentukan profil konfigurasi. Setelah menentukan profil konfigurasi yang valid, Alibaba Cloud CLI akan mengabaikan konfigurasi kredensial identitas default dan konfigurasi variabel lingkungan serta menggunakan konfigurasi yang Anda tentukan untuk menjalankan perintah.

Contoh: Panggil operasi DescribeInstances dari Elastic Compute Service (ECS) dengan profil konfigurasi akProfile.

aliyun ecs DescribeInstances --profile akProfile

--region

Anda dapat menggunakan opsi --region untuk menentukan wilayah. Setelah menentukan wilayah yang valid, Alibaba Cloud CLI akan mengabaikan wilayah dalam konfigurasi kredensial identitas default dan konfigurasi variabel lingkungan serta menggunakan wilayah yang Anda tentukan untuk menjalankan perintah.

Contoh: Panggil operasi DescribeInstances dari ECS dengan wilayah cn-beijing.

aliyun ecs DescribeInstances --region cn-beijing

--endpoint

Anda dapat menggunakan opsi --endpoint untuk menentukan titik akhir. Untuk informasi tentang titik akhir yang didukung oleh layanan Alibaba Cloud, lihat topik Endpoints di bagian Developer Reference > API Reference dalam dokumentasi layanan tersebut.

Contoh: Panggil operasi DescribeMonitorGroups dari CloudMonitor dengan titik akhir metrics.cn-qingdao.aliyuncs.com.

aliyun cms DescribeMonitorGroups --endpoint metrics.cn-qingdao.aliyuncs.com

--version

Anda dapat menggunakan opsi --version untuk menentukan versi API. Opsi ini harus digunakan bersamaan dengan opsi --force. Untuk informasi lebih lanjut, lihat Panggil paksa operasi API.

Contoh: Panggil operasi DescribeMetricList dari CloudMonitor dengan versi API 2017-03-01.

aliyun cms QueryMetricList \
  --Project acs_ecs_dashboard \
  --Metric cpu_idle \
  --version 2017-03-01 \
  --force

--header

Anda dapat menggunakan opsi --header untuk menambahkan header permintaan. Anda dapat menggunakan opsi ini berulang kali untuk menambahkan beberapa header permintaan.

Contoh: Tambahkan header permintaan X-foo=bar ke perintah.

aliyun <product> <ApiName> --header X-foo=bar

--body

Anda dapat menggunakan opsi --body untuk menambahkan string sebagai badan permintaan saat Anda memanggil operasi API arsitektur berorientasi sumber daya (ROA).

Contoh: Panggil operasi RunClusterCheck dari Container Service for Kubernetes (ACK) dengan string JSON yang ditentukan sebagai badan permintaan.

aliyun cs POST /clusters/{cluster_id}/checks --body "{\"type\":\"NodePoolUpgrade\",\"target\":\"np1f6779297c4444a3a1cdd29be8e5****\"}"

--body-file

Anda dapat menggunakan opsi --body-file untuk menambahkan file sebagai badan permintaan saat Anda memanggil operasi API panggilan prosedur jarak jauh (RPC). Opsi ini memiliki prioritas lebih tinggi daripada opsi --body.

Contoh: Panggil operasi RunClusterCheck dari Container Service for Kubernetes (ACK) dengan file sebagai badan permintaan.

aliyun cs POST /clusters/{cluster_id}/checks --body-file /usr/local/bin/example.json

{
    "type": "NodePoolUpgrade",
    "target": "np1f6779297c4444a3a1cdd29be8e5****"
}

--read-timeout

Anda dapat menggunakan opsi --read-timeout untuk menentukan periode timeout I/O dalam detik. Setelah menentukan periode timeout I/O yang valid, Alibaba Cloud CLI akan mengabaikan periode timeout I/O dalam konfigurasi kredensial identitas default dan menggunakan periode timeout I/O yang Anda tentukan untuk menjalankan perintah.

Contoh: Tentukan periode timeout I/O selama 20 detik.

aliyun <product> <ApiName> --read-timeout 20

--connect-timeout

Anda dapat menggunakan opsi --connect-timeout untuk menentukan periode timeout koneksi dalam detik. Setelah menentukan periode timeout koneksi yang valid, Alibaba Cloud CLI akan mengabaikan periode timeout koneksi dalam konfigurasi kredensial identitas default dan menggunakan periode timeout koneksi yang Anda tentukan untuk menjalankan perintah.

Contoh: Tentukan periode timeout koneksi selama 20 detik.

aliyun <product> <ApiName> --connect-timeout 20

--retry-count

Anda dapat menggunakan opsi --retry-count untuk menentukan jumlah percobaan ulang yang diizinkan. Setelah menentukan jumlah yang valid, Alibaba Cloud CLI akan mengabaikan konfigurasi percobaan ulang terkait dalam konfigurasi kredensial identitas default dan menggunakan jumlah percobaan ulang yang Anda tentukan untuk menjalankan perintah.

Contoh: Tentukan jumlah percobaan ulang yang diizinkan sebanyak 5.

aliyun <product> <ApiName> --retry-count 5

--secure

Anda dapat menggunakan opsi --secure untuk mengaktifkan mode HTTPS. Namun, jika operasi API tidak mendukung HTTPS, permintaan akan gagal.

--insecure

Anda dapat menggunakan opsi --insecure untuk mengaktifkan mode HTTP. Namun, jika operasi API tidak mendukung HTTP, permintaan akan gagal.

--quiet,-q

Anda dapat menggunakan opsi --quiet untuk menonaktifkan keluaran hasil pengembalian.

--help

Anda dapat menggunakan opsi --help untuk mendapatkan informasi bantuan tentang suatu perintah.

Untuk informasi lebih lanjut, lihat Gunakan perintah bantuan.

--output,-o

Anda dapat menggunakan opsi --output untuk menentukan bidang yang akan dikembalikan dalam bentuk tabel.

Untuk informasi lebih lanjut, lihat Ekstrak parameter dan tabulasikan keluaran.

--pager

Anda dapat menggunakan opsi --pager untuk menentukan agar hasil agregat dari operasi API paging dikembalikan.

Untuk informasi lebih lanjut, lihat Agregat hasil operasi paging.

--force

Anda dapat menggunakan opsi --force untuk menentukan agar operasi API dipanggil secara paksa dan menggunakan parameter yang tidak ada dalam daftar metadata.

Untuk informasi lebih lanjut, lihat Panggil paksa operasi API.

--waiter

Anda dapat menggunakan opsi --waiter untuk menentukan agar hasil pengembalian dipantau dan data dikembalikan ketika suatu bidang berubah menjadi nilai tertentu.

Untuk informasi lebih lanjut, lihat Pantau hasil pengembalian.

--dryrun

Anda dapat menggunakan opsi --dryrun untuk menentukan agar pemanggilan ke server disimulasikan dan hasil simulasi dikembalikan tanpa melakukan operasi aktual pada sumber daya cloud.

Untuk informasi lebih lanjut, lihat Simulasikan pemanggilan.