Alibaba Cloud CLI adalah alat baris perintah serbaguna yang dikembangkan berdasarkan OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk mengimplementasikan pengelolaan dan pemeliharaan otomatis sumber daya Alibaba Cloud CDN. Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API Alibaba Cloud CDN.
Sebelum memulai
Pelajari Alibaba Cloud CLI. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?
Instal Alibaba Cloud CLI
Anda harus menginstal Alibaba Cloud CLI sebelum dapat menggunakannya. Anda dapat menginstal Alibaba Cloud CLI di sistem operasi Windows, Linux, dan macOS. Pilih paket instalasi sesuai dengan sistem operasi perangkat Anda. Untuk informasi lebih lanjut, lihat topik-topik berikut:
Sistem operasi Windows: Instal Alibaba Cloud CLI di Windows.
Sistem operasi Linux: Instal Alibaba Cloud CLI di Linux.
Sistem operasi macOS: Instal Alibaba Cloud CLI di macOS.
Anda juga dapat menggunakan Cloud Shell yang disediakan oleh Alibaba Cloud untuk men-debug perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi lebih lanjut tentang Cloud Shell, lihat Apa itu Cloud Shell?
Konfigurasikan Alibaba Cloud CLI
Akun Alibaba Cloud memiliki izin untuk mengelola dan mengakses API semua layanan Alibaba Cloud. Jika Anda menggunakan akun Alibaba Cloud untuk memanggil operasi API, risiko keamanan mungkin timbul. Kami merekomendasikan agar Anda membuat dan menggunakan Pengguna Resource Access Management (RAM) untuk memanggil operasi API atau melakukan operasi O&M rutin.
Sebelum menggunakan Alibaba Cloud CLI, Anda harus mengonfigurasi informasi seperti kredensial identitas dan ID wilayah di Alibaba Cloud CLI. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi lebih lanjut, lihat Jenis-jenis Kredensial. Dalam contoh ini, kredensial AccessKey digunakan.
Buat pengguna RAM dan berikan izin yang diperlukan kepada pengguna RAM tersebut. Untuk informasi lebih lanjut, lihat Buat Pengguna RAM dan Berikan Izin kepada Pengguna RAM.
PentingDalam contoh ini, Anda perlu melampirkan kebijakan
AliyunCDNReadOnlyAccesske pengguna RAM. Anda dapat menggunakan kebijakan sistemAliyunCDNFullAccess, yang memberikan pengguna akses penuh ke domain akselerasi CDN Alibaba Cloud, seperti menanyakan dan mengelola domain. Anda juga dapat membuat kebijakan kustom. Untuk informasi lebih lanjut, lihat Kebijakan Kustom Alibaba Cloud CDN.Buat pasangan AccessKey untuk pengguna RAM dan catat
ID AccessKeydanRahasia AccessKeyuntuk konfigurasi kredensial identitas. Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey.Peroleh dan catat ID wilayah yang tersedia untuk konfigurasi kredensial identitas. Alibaba Cloud CLI menggunakan ID wilayah yang ditentukan untuk memulai panggilan API. Untuk informasi lebih lanjut tentang wilayah yang tersedia, lihat Struktur Permintaan.
CatatanSaat menggunakan Alibaba Cloud CLI, Anda dapat menggunakan opsi
--regionuntuk menjalankan perintah di wilayah tertentu. Jika Anda menggunakan opsi ini, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan. Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial identitas dalam file konfigurasi bernama
AkProfile. Untuk informasi lebih lanjut, lihat Endpoints.
Hasilkan perintah CLI
Pergi ke halaman Debugging dari API Alibaba Cloud CDN.
Di dalam kotak pencarian di sisi kiri pada halaman yang muncul, cari operasi yang ingin Anda panggil. Pada tab Parameters, masukkan nilai parameter berdasarkan dokumen API dari Operasi API tersebut. Kemudian, klik tab CLI Example di sisi kanan tab Parameters untuk menghasilkan contoh yang berisi parameter yang telah dikonfigurasi.

Klik ikon
. Anda akan diarahkan ke Cloud Shell. Anda dapat men-debug perintah di Cloud Shell.Klik ikon
untuk menyalin perintah CLI ke clipboard dan tempelkan perintah tersebut ke shell lokal.Saat menempelkan perintah contoh ke shell Anda untuk debugging, perhatikan format parameternya. Untuk informasi lebih lanjut tentang format parameter Alibaba Cloud CLI, lihat Format Parameter.
Secara default, OpenAPI Explorer menambahkan opsi
--regionke perintah CLI yang dihasilkan. Saat Anda menyalin perintah ke shell Anda, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan, dan secara prioritas menjalankan perintah di wilayah yang ditentukan. Anda dapat menghapus atau menyimpan opsi tersebut sesuai dengan kebutuhan bisnis Anda.
Panggil operasi API
Sintaksis
Di Alibaba Cloud CLI, Anda dapat menggunakan sintaksis berikut untuk menjalankan perintah. Untuk informasi lebih lanjut, lihat Hasilkan dan Jalankan Perintah CLI.
aliyun <command> <subcommand> [opsi dan parameter]Opsi perintah
Saat menggunakan Alibaba Cloud CLI, Anda dapat menentukan opsi perintah untuk mengubah perilaku perintah atau mengimplementasikan fitur tambahan dari perintah. Dalam banyak kasus, opsi perintah berikut digunakan:
--profile<profileName>: Anda dapat menggunakan opsi--profiledan parameterprofileNameuntuk menentukan profil konfigurasi. Setelah Anda menentukan profil konfigurasi yang valid, Alibaba Cloud CLI mengabaikan informasi dalam konfigurasi kredensial default dan pengaturan variabel lingkungan dan secara prioritas menggunakan konfigurasi yang Anda tentukan untuk menjalankan perintah.--help: Anda dapat menggunakan opsi--helpuntuk mendapatkan informasi bantuan tentang suatu perintah. Untuk informasi lebih lanjut, lihat Gunakan Perintah Help.
Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.
Contoh pemanggilan
Contoh berikut menunjukkan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi DescribeUserDomains dari Alibaba Cloud CDN untuk menanyakan semua domain di akun Anda dan statusnya. Untuk informasi lebih lanjut tentang operasi DescribeUserDomains, lihat DescribeUserDomains.
Jalankan perintah berikut:

Lihat keluaran perintah.

Jika terjadi kesalahan setelah Anda memanggil operasi API dari Alibaba Cloud CDN, periksa apakah parameter input dan nilainya valid berdasarkan kode kesalahan.
Anda juga dapat menggunakan Alibaba Cloud OpenAPI Diagnostics untuk melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK.