全部產品
Search
文件中心

:GetDasProServiceUsage - 查詢DAS企業版(V1或V2)儲存空間使用方式

更新時間:Dec 19, 2025

調用GetDasProServiceUsage介面,查詢資料庫執行個體DAS企業版 V1或企業版 V2儲存空間的使用方式。

介面說明

  • 當前支援的資料庫請參見 DAS 企業版使用說明

  • 使用阿里雲或 DAS 的 SDK 時,建議使用最新版本。

  • 在使用 SDK 調用 DAS 服務時,需要將地區指定為 cn-shanghai。

  • 該介面僅適用於 DAS 企業版 V1、V2。

說明

推薦使用 DescribeSqlLogStatistic 介面,查詢 DAS 企業版的資料統計資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

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

資料庫執行個體的企業版是否到期:

  • true:到期。

  • false:未到期。

false

region

string

資料庫執行個體所屬的地區。

cn-shanghai

serviceUnitId

string

服務單元 ID。

4

sqlRetention

string

SQL 洞察資料存放區時間長度,單位為天。

180

migrationPredictRemainingTime

integer

舊版 SQL 洞察和審計遷移到新版的預計剩餘時間,單位為毫秒。

重要 僅當進行舊版 SQL 洞察和審計遷移到新版操作時,返回此參數。

60000

Code

integer

返回的狀態代碼。

200

Success

boolean

請求是否執行成功:

  • true:執行成功。

  • false:執行失敗。

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. 沒有許可權執行該操作

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情