本文介紹如何使用阿里云Python語言SDK開發包,調用云數據庫HBase版的DescribeInstances接口(查詢實例列表及其基本信息)。
查看OpenAPI文檔
在調用OpenAPI前,建議您先閱讀對應接口文檔,了解、學習調用該接口所需要的參數及權限等,更多信息請參見API概覽。
創建RAM用戶并完成授權
如您已創建RAM用戶且已完成授權,可跳過此步驟。
創建RAM用戶:
訪問RAM用戶列表,單擊創建用戶。
設置登錄名稱為hbase-openapi-operator,選擇訪問方式為OpenAPI 調用訪問。
單擊確定,創建RAM用戶并保存AccessKey ID與AccessKey Secret信息。
完成授權:
訪問RAM用戶列表,單擊目標RAM用戶操作列的添加權限。
在文本框中搜索
AliyunHBase
,選擇AliyunHBaseReadOnlyAccess策略。說明AliyunHBaseReadOnlyAccess策略擁有查詢HBase實例的操作權限,您也可以按需選擇AliyunHBaseFullAccess權限(具有查詢、修改HBase實例的完全控制權限)或進行自定義策略,更多信息請參見自定義RAM授權策略。
單擊確定,完成授權操作。
調用OpenAPI
本文介紹阿里云Python語言SDK方式調用OpenAPI,其他語言SDK的用法也類似,更多信息請參見云數據庫HBase版SDK。
準備Python環境
下載并安裝Python 3。如您已安裝Python,查看Python版本的命令示例:python --version
。
配置環境變量
配置環境變量ALIBABA_CLOUD_ACCESS_KEY_ID
和ALIBABA_CLOUD_ACCESS_KEY_SECRET
。
Linux和macOS系統:將以下命令中的
<access_key_id>
和<access_key_secret>
替換為您自己的AccessKey ID和AccessKey Secret,然后在終端設備中逐條運行。export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id> export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
Windows系統:新建環境變量文件,添加環境變量
ALIBABA_CLOUD_ACCESS_KEY_ID
和ALIBABA_CLOUD_ACCESS_KEY_SECRET
,并寫入已準備好的AccessKey ID和AccessKey Secret。然后重啟Windows系統。
安裝依賴
在終端設備中,逐條運行如下命令,安裝環境依賴。
pip install alibabacloud_credentials
pip install alibabacloud_hbase20190101
pip install alibabacloud_tea_console
下載示例代碼
訪問DescribeInstances,進入該接口在OpenAPI門戶的調試地址。
在左側的參數配置頁簽,填寫需要的參數信息,本示例需在RegionId參數中輸入cn-hangzhou。
在右側的SDK示例頁簽,選擇Python語言,單擊下載完整工程按鈕,下載示例代碼包。
本地解壓并進入alibabacloud_sample目錄。
運行代碼
執行以下命令。
python sample.py
返回示例如下。
[
LOG
] {
"headers": {
"date": "Mon, 24 Jul 2023 09:56:30 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "943",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "C20BAA8E-C543-58F1-A611-9C812336****",
"x-acs-trace-id": "63ca81587ddddeb0d47443462b3d****",
"etag": "919xrdSHGE5LzH4To3ra****"
},
"body": {
"Instances":{
"Instance": [
{
"BackupStatus": "open",
"ClusterId": "ld-bp1st3v9780tk****",
"ClusterName": "Test",
"ClusterType": "cluster",
"ColdStorageStatus": "open",
"CoreDiskCount": 4,
"CoreDiskSize": 100,
"CoreDiskType": "cloud_ssd",
"CoreInstanceType": "hbase.sn2.large",
"CoreNodeCount": 4,
"CreatedTime": "2023-07-24T17:44:54",
"CreatedTimeUTC": "2023-07-24T09:44:54Z",
"Engine": "hbaseue",
"InstanceId": "ld-bp1st3v9780tk****",
"InstanceName": "Test",
"IsDeletionProtection": false,
"IsHa": true,
"MajorVersion": "2.0",
"MasterDiskSize": 0,
"MasterDiskType": "",
"MasterInstanceType": "hbase.sn1.large",
"MasterNodeCount": 2,
"ModuleId": 0,
"NetworkType": "VPC",
"PayType": "Postpaid",
"RegionId": "cn-hangzhou",
"ResourceGroupId": "rg-acfmz7u4zzr****",
"Status": "ACTIVATION",
"Tags": {
"Tag": []
},
"VpcId": "vpc-bp16crlc5o2dmwi8p****",
"VswitchId": "vsw-bp1sueafuqh4ly8ae****",
"ZoneId": "cn-hangzhou-f"
}
]
},
"PageNumber": 1,
"PageSize": 10,
"RequestId": "C20BAA8E-C543-58F1-A611-9C812336****",
"TotalCount": 1
}
}