All Products
Search
Document Center

ApsaraDB for HBase:Contoh integrasi CLI

Last Updated:Jun 21, 2026

Alibaba Cloud Command Line Interface (Alibaba Cloud CLI) adalah alat terpadu yang dibangun di atas OpenAPI Explorer. Alibaba Cloud CLI memungkinkan Anda mengotomatiskan pengelolaan dan pemeliharaan ApsaraDB for Hbase. Topik ini menjelaskan cara memanggil operasi API ApsaraDB for Hbase menggunakan Alibaba Cloud CLI.

Prasyarat

Jika Anda belum familiar dengan Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI?.

Instal Alibaba Cloud CLI

Untuk menggunakan Alibaba Cloud CLI, Anda harus menginstalnya terlebih dahulu. Alibaba Cloud CLI menyediakan installer untuk Windows, Linux, dan macOS. Pilih installer yang sesuai dengan sistem operasi Anda.

Anda juga dapat menggunakan Cloud Shell untuk debugging perintah Alibaba Cloud CLI. Untuk informasi selengkapnya tentang Cloud Shell, lihat Apa itu Cloud Shell?.

Konfigurasi Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin penuh untuk semua API produk, sehingga menimbulkan risiko keamanan tinggi. Kami sangat menyarankan agar Anda membuat dan menggunakan RAM user untuk pemanggilan API dan tugas O&M harian.

Sebelum menggunakan Alibaba Cloud CLI, Anda harus mengonfigurasi kredensial identitas dan wilayah default. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi selengkapnya, lihat Konfigurasi dan kelola kredensial identitas. Contoh ini menggunakan pasangan AccessKey. Ikuti langkah-langkah berikut:

  1. Buat RAM user dan berikan izin yang diperlukan. Untuk informasi selengkapnya, lihat Buat RAM user dan Kelola izin RAM user.

    Penting

    Untuk contoh ini, Anda harus menyambungkan kebijakan AliyunHBaseReadOnlyAccess ke RAM user tersebut. Anda juga dapat menyambungkan kebijakan AliyunHBaseFullAccess, yang memberikan izin penuh untuk melakukan kueri dan memodifikasi instans ApsaraDB for HBase, atau membuat kebijakan kustom sesuai kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Buat kebijakan otorisasi RAM kustom.

  2. Setelah membuat dan memberikan otorisasi kepada RAM user, buat pasangan AccessKey untuknya. Catat AccessKey ID dan AccessKey Secret. Untuk informasi selengkapnya, lihat Buat pasangan AccessKey.

  3. Dapatkan dan catat ID wilayah yang tersedia. Alibaba Cloud CLI mengirim permintaan API ke wilayah yang Anda tentukan. Untuk daftar wilayah yang tersedia, lihat Struktur permintaan.

    Catatan

    Anda dapat menambahkan opsi --region ke perintah untuk menentukan wilayah bagi permintaan API. Opsi ini menggantikan wilayah yang ditentukan dalam file konfigurasi dan variabel lingkungan Anda. Untuk informasi selengkapnya, lihat Opsi command-line.

  4. Gunakan pasangan AccessKey RAM user untuk mengonfigurasi profil. Contoh ini memberi nama profil AkProfile. Untuk informasi selengkapnya, lihat Konfigurasi dan kelola kredensial identitas.

Buat contoh perintah CLI

  1. Buka halaman Debugging API untuk ApsaraDB for HBase di OpenAPI Explorer.

  2. Pada halaman Debugging API, Anda dapat mencari API yang ingin digunakan di kotak pencarian di sebelah kiri. Di Parameter Configuration, tentukan parameter sesuai dokumentasi API, lalu klik tab CLI Example di sebelah kanan Parameter Configuration untuk menghasilkan contoh perintah dengan parameter tersebut.

    • Klik ikon image untuk membuka Cloud Shell dan debug perintah tersebut.

    • Klik ikon image untuk menyalin contoh CLI ke clipboard. Anda kemudian dapat menempelkannya ke terminal lokal dan menjalankannya.

      • Saat menyalin contoh CLI ke shell lokal untuk debugging, perhatikan format parameternya. Untuk informasi selengkapnya tentang format parameter Alibaba Cloud CLI, lihat Format parameter.

      • OpenAPI Explorer secara default menambahkan opsi --region ke perintah. Opsi ini menggantikan pengaturan wilayah dalam profil dan variabel lingkungan Anda. Anda dapat menghapus atau mempertahankan opsi ini sesuai kebutuhan.

Panggil operasi API

Struktur perintah

Sintaks umum untuk perintah Alibaba Cloud CLI adalah sebagai berikut: Untuk informasi selengkapnya, lihat Hasilkan dan jalankan perintah CLI.

aliyun <command> <subcommand> [options and parameters]

Opsi perintah umum

Anda dapat menggunakan opsi command-line untuk mengubah perilaku default perintah atau menambahkan fungsionalitas. Opsi command-line umum adalah sebagai berikut:

  • --profile <profileName>: Menggunakan profil tertentu untuk menjalankan perintah. Opsi --profile menggantikan profil default dan variabel lingkungan.

  • --help: Menampilkan informasi bantuan untuk perintah saat ini. Untuk informasi selengkapnya, lihat Dapatkan informasi bantuan.

Untuk informasi selengkapnya, lihat Opsi command-line.

Contoh

Contoh berikut menunjukkan cara memanggil operasi DescribeInstance untuk melakukan kueri terhadap instans ApsaraDB for HBase tertentu. Untuk informasi selengkapnya tentang operasi DescribeInstance, lihat DescribeInstance.

  1. Jalankan perintah.

    aliyun hbase DescribeInstance --region cn-hangzhou --ClusterId 'ld-bp142678b0894****'
  2. Perintah tersebut mengembalikan output berikut.

    {
            "BackupStatus": "open",
            "ClusterId": "ld-bp142678b0894****",
            "ClusterName": "hbaseue_test",
            "ClusterType": "cluster",
            "ColdStorageSize": 0,
            "ColdStorageStatus": "open",
            "ConfirmMaintainTime": false,
            "CoreDiskCount": 4,
            "CoreDiskSize": 100,
            "CoreDiskType": "cloud_ssd",
            "CoreInstanceType": "hbase.sn2.2xlarge",
            "CoreNodeCount": 4,
            "CreatedTime": "2024-08-06T11:20:36",
            "CreatedTimeUTC": "2024-08-06T03:20:36Z",
            "EnableHbaseProxy": false,
            "EncryptionType": "NoEncryption",
            "Engine": "hbaseue",
            "InstanceId": "ld-bp142678b0894****",
            "InstanceName": "hbaseue_test",
            "IsDeletionProtection": false,
            "IsHa": true,
            "IsLatestVersion": false,
            "IsMultiModel": true,
            "MaintainEndTime": "06:00:00",
            "MaintainStartTime": "02:00:00",
            "MajorVersion": "2.0",
            "MasterDiskSize": 0,
            "MasterDiskType": "",
            "MasterInstanceType": "hbase.sn1.large",
            "MasterNodeCount": 2,
            "ModuleId": 0,
            "ModuleStackVersion": "2.0",
            "NeedUpgrade": false,
            "NeedUpgradeComps": {
                    "Comps": []
            },
            "NetworkType": "VPC",
            "PayType": "Postpaid",
            "RegionId": "cn-hangzhou",
            "RequestId": "FBEE6642-D79E-5***-****-C4AF1******",
            "ResourceGroupId": "rg-acfmz7u4zzr****",
            "Status": "ACTIVATION",
            "Tags": {
                    "Tag": []
            },
            "TaskProgress": "0",
            "TaskStatus": "running",
            "VpcId": "vpc-bp1ov7as4yvz4kxei****",
            "VswitchId": "vsw-bp1wh6lp1abs3fi0h****",
            "ZoneId": "cn-hangzhou-b"
    }