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.
-
Windows: Instal Alibaba Cloud CLI di Windows.
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
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:
-
Buat RAM user dan berikan izin yang diperlukan. Untuk informasi selengkapnya, lihat Buat RAM user dan Kelola izin RAM user.
PentingUntuk contoh ini, Anda harus menyambungkan kebijakan
AliyunHBaseReadOnlyAccesske RAM user tersebut. Anda juga dapat menyambungkan kebijakanAliyunHBaseFullAccess, 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. -
Setelah membuat dan memberikan otorisasi kepada RAM user, buat pasangan AccessKey untuknya. Catat
AccessKey IDdanAccessKey Secret. Untuk informasi selengkapnya, lihat Buat pasangan AccessKey. -
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.
CatatanAnda dapat menambahkan opsi
--regionke 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. -
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
-
Buka halaman Debugging API untuk ApsaraDB for HBase di OpenAPI Explorer.
-
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
untuk membuka Cloud Shell dan debug perintah tersebut. -
Klik ikon
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
--regionke 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--profilemenggantikan 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.
-
Jalankan perintah.
aliyun hbase DescribeInstance --region cn-hangzhou --ClusterId 'ld-bp142678b0894****' -
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" }