Contoh integrasi CLI - File Storage NAS

Antarmuka Baris Perintah (CLI) Alibaba Cloud adalah alat baris perintah tujuan umum yang dikembangkan berdasarkan API. Anda dapat menggunakan Alibaba Cloud CLI untuk berinteraksi dengan File Storage NAS (NAS) dan mengelola sumber daya NAS melalui alat shell. Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API NAS.

Informasi latar belakang

Untuk informasi lebih lanjut tentang Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI?.

Instal Alibaba Cloud CLI

Anda harus menginstal Alibaba Cloud CLI sebelum dapat menggunakannya. CLI ini tersedia untuk sistem operasi Windows, Linux, dan macOS. Pilih paket instalasi sesuai dengan sistem operasi perangkat Anda. Untuk detail lebih lanjut, lihat topik-topik berikut:

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

Penting

Akun Alibaba Cloud memiliki izin untuk memanggil semua operasi API. Menggunakan akun utama untuk melakukan operasi merupakan operasi berisiko tinggi. Kami menyarankan Anda untuk memanggil operasi API atau melakukan pemeliharaan rutin sebagai Pengguna Resource Access Management (RAM). Pastikan untuk melampirkan kebijakan AliyunNASFullAccess kepada pengguna RAM.

Sebelum menggunakan Alibaba Cloud CLI, konfigurasikan informasi kredensial seperti identitas dan ID wilayah di CLI. CLI mendukung berbagai jenis kredensial identitas. Untuk informasi lebih lanjut, lihat Jenis Kredensial Identitas. Dalam contoh ini, digunakan kredensial AccessKey. Ikuti langkah-langkah berikut:

Buat pengguna RAM dan berikan izin untuk mengelola layanan Alibaba Cloud sesuai kebutuhan bisnis Anda. Untuk detail lebih lanjut, lihat Buat Pengguna RAM dan Berikan Izin kepada Pengguna RAM.
Buat pasangan AccessKey untuk pengguna RAM dan catat ID AccessKey serta Rahasia AccessKey untuk konfigurasi kredensial identitas selanjutnya. Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey.
Tentukan ID wilayah. Alibaba Cloud CLI memanggil operasi API di wilayah yang ditentukan. Untuk informasi lebih lanjut tentang wilayah yang tersedia, lihat Endpoints.
Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial identitas dalam file konfigurasi bernama AkProfile. Untuk informasi lebih lanjut, lihat Contoh Konfigurasi.

Hasilkan perintah CLI

Masuk ke OpenAPI Portal dan klik File Storage NAS.
Di kotak pencarian di sebelah kiri halaman debugging API, cari operasi API yang ingin Anda panggil. Di tab Parameters dari operasi API, tentukan parameter berdasarkan referensi API. Klik tab CLI Example di sebelah kanan tab Parameters untuk melihat perintah sampel yang dihasilkan yang berisi parameter yang ditentukan.
- Klik ikon Run Command untuk memulai Cloud Shell dan debug perintah di Cloud Shell.
- Klik ikon Copy untuk menyalin perintah sampel ke clipboard. Anda dapat menempelkan perintah sampel ke alat shell Anda untuk menjalankannya.
  - Perhatikan format parameter saat menyalin dan menempelkan perintah CLI ke shell lokal. Untuk informasi lebih lanjut tentang format parameter Alibaba Cloud CLI, lihat Format Parameter.
  - Secara default, opsi --region ditambahkan ke perintah sampel yang dihasilkan di OpenAPI Explorer. Saat menyalin perintah ke alat shell Anda, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan, dan menjalankan perintah di wilayah yang ditentukan secara prioritas. Anda dapat menghapus atau menyimpan opsi ini sesuai kebutuhan bisnis Anda.

Gunakan Alibaba Cloud CLI untuk memanggil operasi API NAS

Sintaksis

Di Alibaba Cloud CLI, gunakan 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. Berikut adalah opsi perintah yang sering digunakan:

--profile<profileName>: Setelah menggunakan opsi --profile dan parameternya profileName untuk menentukan profil konfigurasi, Alibaba Cloud CLI mengabaikan konfigurasi kredensial identitas default dan pengaturan variabel lingkungan, serta menggunakan konfigurasi yang Anda tentukan untuk menjalankan perintah.
--help: Tentukan opsi --help untuk mendapatkan informasi bantuan tentang perintah. Untuk informasi lebih lanjut, lihat Gunakan Perintah Help.

Contoh

Catatan

Dalam contoh-contoh berikut, perintah dijalankan di Command Prompt Windows. Format parameter perintah bervariasi di sistem operasi lain. Untuk informasi lebih lanjut tentang format parameter Alibaba Cloud CLI, lihat Format Parameter.

Contoh 1: Gunakan Alibaba Cloud CLI untuk memanggil CreateFileSystem operasi NAS untuk membuat file system Network File System (NFS) Kapasitas Tujuan Umum dengan model bayar sesuai pemakaian.
1. Jalankan perintah berikut:
```
aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS
```
2. Lihat keluaran perintah.
```
{
        "FileSystemId": "6a2464****",
        "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
}
```

Contoh 2: Gunakan Alibaba Cloud CLI untuk memanggil CreateAccessGroup operasi NAS untuk membuat grup akses bernama vpc_test.

Jalankan perintah berikut:

aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc

Lihat keluaran perintah.

{
        "AccessGroupName": "vpc_test",
        "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54"
}

Catatan

Jika terjadi kesalahan setelah Anda memanggil operasi API NAS, periksa apakah parameter permintaan dan nilainya valid berdasarkan kode kesalahan yang dikembalikan.

Anda juga dapat melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK di halaman Diagnosis Masalah OpenAPI.