All Products
Search
Document Center

File Storage NAS:Contoh integrasi CLI

Last Updated:Jun 22, 2026

Alibaba Cloud Command Line Interface (CLI) 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 resource NAS melalui shell. Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API NAS.

Informasi latar belakang

Untuk informasi selengkapnya tentang Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI.

Instal Alibaba Cloud CLI

Anda harus menginstal Alibaba Cloud CLI sebelum menggunakannya. Alibaba Cloud CLI dapat diinstal pada sistem operasi Windows, Linux, dan macOS. Pilih paket instalasi yang sesuai dengan sistem operasi perangkat Anda. Untuk informasi selengkapnya, lihat topik-topik berikut:

Anda juga dapat menggunakan Cloud Shell yang disediakan oleh Alibaba Cloud untuk melakukan debugging perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi selengkapnya tentang Cloud Shell, lihat Apa itu Cloud Shell?.

Konfigurasi Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin untuk memanggil semua operasi API. Menggunakan akun Alibaba Cloud untuk melakukan operasi merupakan operasi berisiko tinggi. Kami menyarankan agar Anda memanggil operasi API atau melakukan O&M rutin sebagai Pengguna Resource Access Management (RAM). Anda harus menyambungkan kebijakan AliyunNASFullAccess ke pengguna RAM tersebut.

Sebelum menggunakan Alibaba Cloud CLI, Anda harus mengonfigurasi informasi kredensial seperti kredensial identitas dan ID wilayah. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi selengkapnya, lihat Jenis kredensial identitas. Dalam contoh ini, digunakan kredensial AccessKey. Ikuti langkah-langkah berikut:

  1. Buat pengguna RAM dan berikan izin untuk mengelola layanan Alibaba Cloud sesuai kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Buat pengguna RAM dan Kelola izin pengguna RAM.

  2. Buat Pasangan Kunci Akses untuk pengguna RAM tersebut dan catat ID AccessKey dan Rahasia AccessKey untuk konfigurasi kredensial identitas selanjutnya. Untuk informasi selengkapnya, lihat Buat AccessKey.

  3. Tentukan ID wilayah. Alibaba Cloud CLI memanggil operasi API di wilayah yang ditentukan. Untuk informasi selengkapnya tentang wilayah yang tersedia, lihat Endpoint.

  4. Gunakan Pasangan Kunci Akses pengguna RAM untuk mengonfigurasi kredensial identitas dalam file konfigurasi bernama AkProfile. Untuk informasi selengkapnya, lihat Konfigurasi dan kelola kredensial.

Buat perintah CLI

  1. Login ke OpenAPI Portal.

  2. Pada halaman debugging API, cari API yang ingin digunakan di kotak pencarian di sebelah kiri. Di bagian Parameter Configuration, masukkan parameter sesuai dokumentasi API, lalu klik tab CLI Example di sebelah kanan Parameter Configuration untuk menghasilkan contoh perintah dengan parameter tersebut.

    • Klik Run Command untuk membuka Cloud Shell dan melakukan debugging perintah secara cepat.

    • Klik Copy untuk menyalin contoh perintah ke clipboard Anda. Anda kemudian dapat menempelkannya ke shell lokal untuk menjalankannya.

      • Perhatikan format parameter saat menyalin dan menempel perintah CLI ke shell lokal. Untuk informasi selengkapnya tentang format parameter Alibaba Cloud CLI, lihat Pahami parameter perintah.

      • Secara default, opsi --region ditambahkan ke perintah contoh yang dihasilkan di OpenAPI Explorer. Saat Anda menyalin perintah tersebut ke shell, Alibaba Cloud CLI akan mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan, serta menjalankan perintah di wilayah yang ditentukan. Anda dapat menghapus atau mempertahankan opsi ini sesuai kebutuhan bisnis Anda.

Gunakan Alibaba Cloud CLI untuk memanggil operasi API NAS

Sintaksis

Di Alibaba Cloud CLI, Anda dapat menggunakan sintaksis berikut untuk menjalankan perintah. Untuk informasi selengkapnya, lihat Buat dan jalankan perintah CLI dengan OpenAPI Explorer.

aliyun <command> <subcommand> [opsi dan parameter]

Opsi perintah

Saat menggunakan Alibaba Cloud CLI, Anda dapat menentukan opsi perintah untuk mengubah perilaku perintah atau mengaktifkan fitur tambahan. Berikut beberapa opsi perintah yang sering digunakan:

  • --profile<profileName>: Setelah Anda menggunakan opsi --profile beserta parameternya profileName untuk menentukan profil konfigurasi, Alibaba Cloud CLI akan mengabaikan konfigurasi kredensial identitas default dan variabel lingkungan, lalu menggunakan konfigurasi yang Anda tentukan untuk menjalankan perintah.

  • --help: Anda dapat menentukan opsi --help untuk mendapatkan informasi bantuan tentang suatu perintah. Untuk informasi selengkapnya, lihat Gunakan perintah help.

Contoh

Catatan

Dalam contoh berikut, perintah dijalankan di Command Prompt Windows. Format parameter perintah berbeda-beda di sistem operasi lain. Untuk informasi selengkapnya tentang format parameter Alibaba Cloud CLI, lihat Pahami parameter perintah.

  • Contoh 1: Gunakan Alibaba Cloud CLI untuk memanggil operasi CreateFileSystem NAS guna membuat sistem file Network File System (NFS) tipe Capacity dengan model bayar sesuai penggunaan (pay-as-you-go) dan tujuan umum.

    1. Jalankan perintah berikut:

      aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS
    2. Lihat output perintah.

      {
              "FileSystemId": "6a2464****",
              "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
      }
  • Contoh 2: Gunakan Alibaba Cloud CLI untuk memanggil operasi CreateAccessGroup NAS guna membuat grup izin bernama vpc_test.

    1. Jalankan perintah berikut:

      aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc
    2. Lihat output 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 menggunakan RequestID atau pesan kesalahan SDK dari respons bersama OpenAPI Diagnostic Platform untuk mendiagnosis masalah tersebut.