本文介紹如何使用阿里云Python語言SDK開發包,調用DAS的GetInstanceInspections(獲取數據庫實例巡檢評分結果)接口。
查看OpenAPI文檔
在調用OpenAPI前,建議您先閱讀對應接口文檔,了解、學習調用該接口所需要的參數及權限等,更多信息請參見API概覽。
創建RAM用戶并完成授權
如您已創建RAM用戶并完成授權,可跳過此步驟。
創建RAM用戶:
訪問RAM用戶列表,單擊創建用戶。
設置登錄名稱為das-openapi-operator,選擇訪問方式為使用永久 AccessKey 訪問。
單擊確定,創建RAM用戶并保存AccessKey ID與AccessKey Secret信息。
完成授權:
調用OpenAPI
本文介紹阿里云Python語言SDK調用OpenAPI,其他語言SDK的用法也類似,更多信息請參見數據庫自治服務DAS 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_das20200116==2.4.2
下載示例代碼
訪問GetInstanceInspections,進入該接口在OpenAPI門戶的調試地址。
在參數配置頁簽,填寫需要的參數信息,本示例以RDS MySQL為例,參數配置如下。
參數
取值
Engine
MySQL
StartTime
1718776527000
重要任務開始時間,格式為 Unix 時間戳,單位為毫秒,請將其替換為實際數值。
EndTime
1718776827000
重要任務結束時間,格式為 Unix 時間戳,單位為毫秒,請將其替換為實際數值。
在指定時間段內需要執行已完成的巡檢評分任務。如果沒有相應任務,您可以選擇一個實例,手動發起巡檢評分,待任務完成后再執行該示例。手動發起巡檢評分請參見巡檢評分。
InstanceArea
RDS
PageNo
1
PageSize
10
在右側的SDK示例頁簽,選擇Python語言,單擊下載完整工程按鈕,下載示例代碼包。
本地解壓并進入alibabacloud_sample目錄。
運行代碼
執行以下命令。
python sample.py
返回示例如下。
{
"headers": {
"date": "Wed, 19 Jun 2024 06:24:10 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "1428",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"vary": "Accept-Encoding",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "B576DACC-D08A-5058-8843-E613CBF474CF",
"x-acs-trace-id": "2fb5b5b76565ce67233288b9369f6d96",
"etag": "1rcNeDQg43APurk7PohefuQ8"
},
"statusCode": 200,
"body": {
"Code": 200,
"Data": {
"List": [
{
"AutoFunction": {
"AutoIndex": 1,
"AutoLimitedSql": 0,
"AutoResourceOptimize": 2,
"AutoScale": 0,
"EventSubscription": 0
},
"Data": {
"hasDeadLock": false,
"slowSqlCount": 0,
"exceptionTableMap": {},
"spaceItem": {
"valid": true,
"current": 0.16416015625,
"avg": 0.16416015625,
"min": 0.16416015625,
"max": 0.16416015625
},
"maxIops": 3100,
"bigTransactionCount": 0,
"cpu": 2,
"isRds": true,
"storage": 20,
"lastHourRate": 0.0,
"lastDayCount": 0,
"lastHourCount": 0,
"slowSqlList": [],
"lastDayRate": 0.0,
"activeSessions": [],
"enable": false,
"bigTransactionList": [],
"bigSessionList": [
{
"User": "system user",
"Command": "Query",
"State": "Replica has read all relay log; waiting for more updates",
"active": false,
"Host": "",
"Time": 24,
"Id": 61,
"Info": "",
"db": ""
}
],
"tableStats": [],
"bigSessionCount": 1,
"spaceUsage": 0.16416015625,
"availableDays": 76
},
"EnableDasPro": 0,
"EndTime": 1718726400000,
"GmtCreate": 1718776692000,
"Instance": {
"AccountId": "1648821913965368",
"Category": "standard",
"Cpu": "2",
"Engine": "MySQL",
"EngineVersion": "8.0",
"InstanceArea": "RDS",
"InstanceClass": "mysql.n2m.medium.2c",
"InstanceId": "rm-bp1s6jtqtr41m****",
"Memory": 4096,
"NetworkType": "VPC",
"Region": "cn-hangzhou",
"Storage": 20,
"Uuid": "hdm_6d00b701adcb484d5fa4d2800dc0****",
"VpcId": "vpc-bp1ov7as4yvz4kxei****"
},
"Score": 100,
"StartTime": 1718640000000,
"State": 2,
"TaskType": 1
}
],
"PageNo": 1,
"PageSize": 10,
"Total": 1
},
"Message": "Successful",
"RequestId": "B576DACC-D08A-5058-8843-E613CBF474CF",
"Success": true
}
}