调用GetDasProServiceUsage接口,查询数据库实例SQL洞察存储空间的使用情况。

  • 当前支持的数据库请参见DAS专业版使用说明
  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetDasProServiceUsage

系统规定参数。取值:GetDasProServiceUsage

UserId String 196278346919****

用户ID,即创建数据库实例的阿里云主账号ID。

说明 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。
InstanceId String rm-2ze8g2am97624****

数据库实例ID。

返回数据

名称 类型 示例值 描述
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
RequestId String 7172BECE-588A-5961-8126-C216E16B****

请求ID。

Data Array of unit

返回数据。

storageFreeQuotaInMB double 5120

赠送的SQL洞察数据存储空间,单位为MB。

ip String rm-2ze8g2am97624****.mysql.****.com

数据库实例的地址。

custinsId Long 57369374

内部标识ID。

userId String 196278346919****

用户ID,即创建数据库实例的阿里云主账号ID。

uuid String hdm_b0ae36343407609bf3e8df8709d8****

数据库实例的唯一标识符号。

expireTime Long 1648742400000

数据库实例专业版到期时间,格式为Unix时间戳,单位为毫秒。

instanceId String rm-2ze8g2am97624****

数据库实例ID。

storageUsed Long 35903498

数据库实例已使用的SQL洞察数据存储空间,单位为Byte。

engine String MySQL

数据库引擎。

instanceAlias String TESTDB01

数据库实例名称。

port Integer 3306

端口号。

vpcId String vpc-2zentqj1sk4qmolci****

VPC ID。

commodityInstanceId String daspro-cn-v0h1l6i****

DAS专业版ID。

startTime Long 1646100892000

开启专业版的时间,格式为Unix时间戳,单位为毫秒。

isSpare Boolean false

数据库实例的专业版是否过期:

  • true:过期。
  • false:未过期。
region String cn-shanghai

数据库实例所属的地域。

serviceUnitId String 4

服务单元ID。

sqlRetention String 180

SQL洞察数据存储时长,单位为天。

Code Long 200

返回的状态码。

Success Boolean true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetDasProServiceUsage
&UserId=196278346919****
&InstanceId=rm-2ze8g2am97624****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetDasProServiceUsageResponse>
    <Message>Successful</Message>
    <RequestId>7172BECE-588A-5961-8126-C216E16B****</RequestId>
    <Data>
        <storageFreeQuotaInMB>5120</storageFreeQuotaInMB>
        <ip>rm-2ze8g2am97624****.mysql.****.com</ip>
        <custinsId>57369374</custinsId>
        <userId>196278346919****</userId>
        <uuid>hdm_b0ae36343407609bf3e8df8709d8****</uuid>
        <expireTime>1648742400000</expireTime>
        <instanceId>rm-2ze8g2am97624****</instanceId>
        <storageUsed>35903498</storageUsed>
        <engine>MySQL</engine>
        <instanceAlias>TESTDB01</instanceAlias>
        <port>3306</port>
        <vpcId>vpc-2zentqj1sk4qmolci****</vpcId>
        <commodityInstanceId>daspro-cn-v0h1l6i****</commodityInstanceId>
        <startTime>1646100892000</startTime>
        <isSpare>false</isSpare>
        <region>cn-shanghai</region>
        <serviceUnitId>4</serviceUnitId>
        <sqlRetention>180</sqlRetention>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</GetDasProServiceUsageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "Successful",
  "RequestId" : "7172BECE-588A-5961-8126-C216E16B****",
  "Data" : [ {
    "storageFreeQuotaInMB" : 5120,
    "ip" : "rm-2ze8g2am97624****.mysql.****.com",
    "custinsId" : 57369374,
    "userId" : "196278346919****",
    "uuid" : "hdm_b0ae36343407609bf3e8df8709d8****",
    "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"
  } ],
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

访问错误中心查看更多错误码。