調用GetDasProServiceUsage介面,查詢資料庫執行個體DAS企業版 V1或企業版 V2儲存空間的使用方式。
介面說明
當前支援的資料庫請參見 DAS 企業版使用說明。
使用阿里雲或 DAS 的 SDK 時,建議使用最新版本。
在使用 SDK 調用 DAS 服務時,需要將地區指定為 cn-shanghai。
該介面僅適用於 DAS 企業版 V1、V2。
推薦使用 DescribeSqlLogStatistic 介面,查詢 DAS 企業版的資料統計資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
hdm:GetDasProServiceUsage |
get |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| UserId |
string |
否 |
使用者識別碼,即建立資料庫執行個體的阿里雲主帳號 ID。 說明
非必填,輸入目標資料庫執行個體 ID 後,在調用 API 介面時,系統會自動擷取使用者識別碼。 |
196278346919**** |
| InstanceId |
string |
是 |
資料庫執行個體 ID。 |
rm-2ze8g2am97624**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| Message |
string |
請求返回訊息。 說明
請求成功時該參數返回 Successful,請求失敗時會返回請求異常資訊(如錯誤碼等)。 |
Successful |
| RequestId |
string |
請求 ID。 |
7172BECE-588A-5961-8126-C216E16B**** |
| Data |
object |
返回資料。 |
{ "storageFreeQuotaInMB": 5120, "ip": "rm-2ze8g2am97624****.mysql.****.com", "custinsId": 12448331, "userId": "196278346919****", "uuid": "hdm_b0ae36343407609bf3e8df8709d8****", "expireTime": 1924963200000, "instanceId": "rm-2ze8g2am97624****", "storageUsed": 10773752667393, "engine": "MySQL", "instanceAlias": "TESTDB01_PROD", "port": 3310, "vpcId": "hdm_****", "commodityInstanceId": "daspro-****", "startTime": 1606381940000, "isSpare": false, "region": "cn-shanghai", "serviceUnitId": "5", "sqlRetention": 30 } |
| storageFreeQuotaInMB |
number |
贈送的 SQL 洞察資料存放區空間,單位為 MB。 |
5120 |
| ip |
string |
資料庫執行個體的地址。 |
rm-2ze8g2am97624****.mysql.****.com |
| userId |
string |
使用者識別碼,即建立資料庫執行個體的阿里雲主帳號 ID。 |
196278346919**** |
| expireTime |
integer |
資料庫執行個體企業版到期時間,格式為 Unix 時間戳記,單位為毫秒。 |
1648742400000 |
| instanceId |
string |
資料庫執行個體 ID。 |
rm-2ze8g2am97624**** |
| storageUsed |
integer |
資料庫執行個體已使用的 SQL 洞察資料存放區空間,單位為 Byte。 |
35903498 |
| engine |
string |
資料庫引擎。 |
MySQL |
| instanceAlias |
string |
資料庫執行個體名稱。 |
TESTDB01 |
| port |
integer |
連接埠號碼。 |
3306 |
| vpcId |
string |
VPC ID。 |
vpc-2zentqj1sk4qmolci**** |
| commodityInstanceId |
string |
DAS 企業版 ID。 |
daspro-cn-v0h1l6i**** |
| startTime |
integer |
開啟企業版的時間,格式為 Unix 時間戳記,單位為毫秒。 |
1646100892000 |
| isSpare |
boolean |
資料庫執行個體的企業版是否到期:
|
false |
| region |
string |
資料庫執行個體所屬的地區。 |
cn-shanghai |
| serviceUnitId |
string |
服務單元 ID。 |
4 |
| sqlRetention |
string |
SQL 洞察資料存放區時間長度,單位為天。 |
180 |
| migrationPredictRemainingTime |
integer |
舊版 SQL 洞察和審計遷移到新版的預計剩餘時間,單位為毫秒。 重要 僅當進行舊版 SQL 洞察和審計遷移到新版操作時,返回此參數。
|
60000 |
| Code |
integer |
返回的狀態代碼。 |
200 |
| Success |
boolean |
請求是否執行成功:
|
true |
樣本
正常返回樣本
JSON格式
{
"Message": "Successful",
"RequestId": "7172BECE-588A-5961-8126-C216E16B****",
"Data": {
"storageFreeQuotaInMB": 5120,
"ip": "rm-2ze8g2am97624****.mysql.****.com",
"userId": "196278346919****",
"expireTime": 1648742400000,
"instanceId": "rm-2ze8g2am97624****",
"storageUsed": 35903498,
"engine": "MySQL",
"instanceAlias": "TESTDB01",
"port": 3306,
"vpcId": "vpc-2zentqj1sk4qmolci****",
"commodityInstanceId": "daspro-cn-v0h1l6i****",
"startTime": 1646100892000,
"isSpare": false,
"region": "cn-shanghai",
"serviceUnitId": "4",
"sqlRetention": "180",
"migrationPredictRemainingTime": 60000
},
"Code": 200,
"Success": true
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | 請求參數錯誤 |
| 403 | NoPermission | You are not authorized to do this action. | 沒有許可權執行該操作 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。