You need to enable JavaScript to run this app.
文档中心
云数据库 MySQL 版

云数据库 MySQL 版

复制全文
下载 pdf
实例管理
DescribeDBInstanceChargeDetail - 查询实例的计费信息
复制全文
下载 pdf
DescribeDBInstanceChargeDetail - 查询实例的计费信息
调用 DescribeDBInstanceChargeDetail 接口查询实例的计费信息。​
请求类型​
同步请求。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceId​
String​
是​
mysql-f83edc2e****​
实例 ID。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
ChargeDetail​
Object of ChargeDetailObject​
请参见返回示例。​
实例的计费方式信息。​
​
ChargeDetailObject​
​
参数​
类型​
示例值​
描述​
AutoRenew​
Boolean​
true​
预付费场景下是否自动续费。​
  • true:到期自动续费。​
  • false:到期不自动续费。​
ChargeEndTime​
String​
2025-08-22T15:59:59.000Z​
包年包月实例的计费结束时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
说明​
如查询的是按量计费实例,该字段返回为空。​
ChargeStartTime​
String​
2025-07-22T13:10:15.000Z​
实例的计费开始时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
ChargeStatus​
String​
Normal​
实例的计费状态。取值:​
  • Normal:正常。​
  • Overdue:欠费。​
  • Unpaid:等待支付。​
ChargeType​
String​
PostPaid​
付费类型。取值:​
  • PostPaid:按量付费(后付费)。​
  • PrePaid:包年包月(预付费)。​
OverdueReclaimTime​
String​
2025-08-29T15:59:59.000Z​
实例欠费关停(按量付费)或到期关停(包年包月)后,预计被释放的时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
OverdueTime​
String​
2025-08-23T04:00:00.000Z​
实例欠费关停(按量付费)或到期关停(包年包月)的时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
Period​
Integer​
1​
预付费场景下的购买时长。​
说明​
  • 该参数作为请求参数时,默认值为 1。​
  • 当 PeriodUnit 的取值为 Year 时,Period 的取值范围为 1~3。​
  • 当 PeriodUnit 的取值为 Month 时,Period 的取值范围为 1~9。​
PeriodUnit​
String​
Month​
预付费场景下的购买周期。​
  • Month:购买周期为月。​
  • Year:购买周期为年。​
说明​
该参数作为请求参数时,默认值为 Month。​
TempModifyStartTime​
String​
2022-01-01T10:10:10.000Z​
临时升配的开始时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
说明​
未处于临时升配期的实例,不返回该字段。​
TempModifyEndTime​
String​
2022-01-01T10:10:09.000Z​
临时升配的还原时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。​
说明​
未处于临时升配期的实例,不返回该字段。​
​
示例​
请求示例​
​
POST /?Action=DescribeDBInstanceChargeDetail&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: rds-mysql.cn-beijing.volcengineapi.com​
X-Date: 20211202T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"InstanceId": "mysql-f83edc2e****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "2025072414470358C0C64BFA4C2A01A242-870b4a",​
"Action": "DescribeDBInstanceChargeDetail",​
"Version": "2022-01-01",​
"Service": "rds_mysql",​
"Region": "cn-guangzhou"​
},​
"Result": {​
"ChargeDetail": {​
"AutoRenew": true,​
"ChargeEndTime": "2025-08-22T15:59:59.000Z",​
"ChargeStartTime": "2025-07-22T13:10:15.000Z",​
"ChargeStatus": "Normal",​
"ChargeType": "PrePaid",​
"OverdueReclaimTime": "2025-08-29T15:59:59.000Z",​
"OverdueTime": "2025-08-23T04:00:00.000Z",​
"Period": 1,​
"PeriodUnit": "Month"​
}​
}​
}​
​
错误码​
更多详情,请参见错误码。​
​
最近更新时间:2026.04.09 11:58:31
这个页面对您有帮助吗?
有用
有用
无用
无用