All Products
Search

This Product

    Data Management:Contoh integrasi CLI – DBS

    Document Center

    Data Management:Contoh integrasi CLI – DBS

    Last Updated:Mar 28, 2026

    Alibaba Cloud CLI memungkinkan Anda mengotomatiskan pengelolaan dan pemeliharaan Pemulihan Bencana Data dari command line. Setelah menyelesaikan tutorial ini, Anda dapat:

    • Menginstal dan mengonfigurasi Alibaba Cloud CLI dengan kredensial RAM user

    • Menemukan operasi API Pemulihan Bencana Data yang tersedia

    • Memanggil operasi API dan menafsirkan responsnya

    Tutorial ini menggunakan DescribeBackupPlanBilling sebagai contoh kerja.

    Prasyarat

    Sebelum memulai, pastikan Anda telah memiliki:

    Penting

    Akun Alibaba Cloud memiliki akses penuh ke semua layanan Alibaba Cloud. Buatlah Pengguna Resource Access Management (RAM) dan berikan hanya izin yang diperlukan, sesuai prinsip hak istimewa minimal. Untuk daftar kebijakan izin yang didukung oleh Pemulihan Bencana Data, lihat Kebijakan sistem yang telah ditentukan dan Kebijakan kustom.

    Langkah 1: Instal Alibaba Cloud CLI

    Pilih opsi yang sesuai dengan lingkungan Anda.

    Opsi A: Gunakan Cloud Shell (tidak perlu instalasi)

    Alibaba Cloud CLI telah dipra-instal di Cloud Shell. Cloud Shell juga secara otomatis mengonfigurasi kredensial identitas, sehingga Anda dapat melewati Langkah 2 dan langsung menuju Langkah 3. Lihat Apa itu Cloud Shell?

    Opsi B: Instal secara lokal

    Alibaba Cloud CLI mendukung Windows, Linux, dan macOS. Ikuti panduan sesuai sistem operasi Anda:

    Untuk ikhtisar tentang Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI?

    Langkah 2: Konfigurasi kredensial

    Catatan

    Lewati langkah ini jika Anda menggunakan Cloud Shell — kredensial dikonfigurasi secara otomatis.

    Konfigurasikan kredensial AccessKey Anda di Alibaba Cloud CLI menggunakan profil AkProfile:

    1. Buat RAM user dan buat pasangan AccessKey untuk pengguna tersebut.

    2. Lampirkan kebijakan AliyunDMSFullAccess ke RAM user tersebut. Lihat Memberikan izin kepada RAM user.

    3. Cari ID wilayah untuk wilayah yang ingin Anda gunakan. Alibaba Cloud CLI mengirim permintaan API ke wilayah yang Anda tentukan. Lihat Titik akhir untuk daftar wilayah yang didukung oleh Pemulihan Bencana Data.

    4. Konfigurasikan kredensial AccessKey dalam file profil AkProfile. Untuk contoh langkah demi langkah, lihat bagian "Contoh konfigurasi" dalam Konfigurasi kredensial.

    Alibaba Cloud CLI mendukung beberapa jenis kredensial. Untuk daftar lengkapnya, lihat bagian "Jenis kredensial" dalam Konfigurasi kredensial.

    Catatan

    Gunakan opsi --region untuk menargetkan wilayah tertentu pada setiap perintah. Opsi ini akan mengganti wilayah yang ditetapkan dalam konfigurasi kredensial dan variabel lingkungan Anda. Lihat Opsi command line untuk pemanggilan API.

    Langkah 3: Hasilkan perintah CLI

    OpenAPI Explorer menghasilkan perintah CLI siap pakai untuk setiap operasi API Pemulihan Bencana Data.

    1. Buka halaman DescribeBackupPlanBilling di OpenAPI Explorer.

      image

    2. Pada tab Parameters, isi parameter permintaan.

    3. Klik tab CLI Example untuk melihat perintah yang dihasilkan.

    4. Salin atau jalankan perintah tersebut:

      • Klik image untuk menjalankan perintah langsung di Cloud Shell.

      • Klik image untuk menyalin perintah ke clipboard Anda, lalu tempelkan ke shell lokal Anda.

    Catatan

    OpenAPI Explorer secara default menambahkan --region ke perintah yang dihasilkan. Saat Anda menjalankan perintah secara lokal, Alibaba Cloud CLI akan menggunakan wilayah tersebut alih-alih wilayah dalam konfigurasi kredensial Anda. Hapus atau pertahankan opsi tersebut sesuai kebutuhan Anda. Untuk detail format parameter, lihat Format parameter.

    Langkah 4: Panggil operasi API

    Alibaba Cloud CLI secara default mengintegrasikan operasi API Pemulihan Bencana Data versi 2019-03-06. Untuk memanggil operasi versi 2021-01-01, gunakan opsi --force dan --version. OpenAPI Explorer secara otomatis menambahkan opsi ini saat Anda membuat perintah untuk API 2021-01-01.

    Untuk alur kerja kompleks yang merangkai beberapa perintah, kompilasikan menjadi skrip shell guna meningkatkan efisiensi.

    Untuk daftar lengkap operasi, lihat:

    Daftar operasi API yang tersedia

    Gunakan opsi --help untuk melihat semua operasi API 2019-03-06 yang tersedia di Alibaba Cloud CLI:

    aliyun dbs --help

    Output yang diharapkan:

    image

    Kueri informasi penagihan jadwal backup

    Contoh berikut memanggil DescribeBackupPlanBilling untuk mengkueri informasi penagihan jadwal backup. Lihat DescribeBackupPlanBilling untuk referensi parameter lengkap.

    aliyun dbs DescribeBackupPlanBilling --BackupPlanId 'dbstooi01ex****' --ShowStorageType true

    Output yang diharapkan:

    {
  "HttpStatusCode": 200,
  "RequestId": "DD7BC7F5-4E3A-5DF3-BFF9-831503C4D9E3",
  "Success": true,
  "Item": {
    "BuyCreateTimestamp": 1658372830000,
    "FullStorageSize": 151,
    "BuyExpiredTimestamp": 1661097600000,
    "BuySpec": "micro",
    "QuotaEndTimestamp": 1659283200000,
    "IsExpired": true,
    "QuotaStartTimestamp": 1656604800000,
    "TotalFreeBytes": 858993459200,
    "PaiedBytes": 0,
    "UsedFullBytes": 0,
    "IsFreeBytesUnlimited": true,
    "ContStorageSize": 10437039,
    "BuyChargeType": "PREPAY",
    "UsedIncrementBytes": 9406734
  }
}

    Pemecahan masalah error

    Jika pemanggilan API mengembalikan error, periksa kode kesalahan dan pastikan parameter permintaan serta nilainya valid.

    Untuk diagnostik self-service, kunjungi OpenAPI Troubleshoot dan masukkan ID permintaan atau informasi error SDK dari respons.

    Langkah selanjutnya