You need to enable JavaScript to run this app.
导航
DescribeDBInstancePriceDetail
最近更新时间:2025.06.09 14:25:48首次发布时间:2023.08.14 13:15:55
我的收藏
有用
有用
无用
无用

调用 DescribeDBInstancePriceDetail 接口查询 MySQL 实例的价格详情。

请求类型

同步请求。

调试

请求参数

参数
类型
是否必选
示例值
描述
NodeInfo
Object[]
请参见请求示例。
实例规格配置。主节点和备节点有且只有 1 个,只读节点可选 0~10 个。
StorageType
String
LocalSSD

实例存储类型。取值为 LocalSSD,表示本地 SSD 盘。

说明

如需设定 StorageSpace 参数,StorageType 参数为必传。

StorageSpace
Integer
100
实例存储空间。取值范围:[20, 3000],单位:GB,步长 10GB。
ChargeType
String
PostPaid

计费类型。取值:

  • PostPaid:按量付费(后付费)。
  • PrePaid:包年包月(预付费)。
PeriodUnit
String
Month

预付费场景下的购买周期。

说明

ChargeType 取值为 PostPaid 时,不需要传入此参数。

  • Month:购买周期为月。默认。
  • Year:购买周期为年。
Period
Integer
2
预付费模式下的时长数量。
Number
Integer
1
实例个数。
ProjectName
String
default

所属的项目。

说明

如您调用接口使用的 AK/SK 属于某个子账号,且该子账号只拥有某个项目的权限,需要传入该请求参数。

ProxyNodeCustom
Object
请参见请求示例。
实例的代理配置。

返回参数

参数
类型
示例值
描述
DescribeDBInstancePriceDetailStr
Object
请参见返回示例。
指定配置的详细计费信息。

示例

请求示例 1

查询实例在后付费(按量计费)方式下的价格。

POST /?Action=DescribeDBInstancePriceDetail&Version=2022-01-01 HTTP/1.1
Accept: application/json
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****
{
    "StorageType": "LocalSSD",
    "StorageSpace": 100,
    "ChargeType": "PostPaid",
    "NodeInfo": [
        {
            "NodeSpec": "rds.mysql.4c8g",
            "NodeType": "Primary"
        },
        {
            "NodeSpec": "rds.mysql.4c8g",
            "NodeType": "Secondary"
        },
        {
            "NodeSpec": "rds.mysql.1c2g",
            "NodeType": "ReadOnly"
        },
        {
            "NodeSpec": "rds.mysql.1c2g",
            "NodeType": "ReadOnly"
        }
    ],
    "Number": 1,
    "ProxyNodeCustom": {
        "CpuNum": 4
    }
}

返回示例 1

{
    "ResponseMetadata": {
        "RequestId": "2025060612093670AA7AD4D88A34BC51E7-708074",
        "Action": "DescribeDBInstancePriceDetail",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "DescribeDBInstancePriceDetailStr": {
            "BillingMethod": "configuration_hourly",
            "ChargeItemPrices": [
                {
                    "ChargeItemKey": "rds.mysql.d1.4c8g_cn-beijing",
                    "ChargeItemType": "Primary",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "0.45",
                    "OriginalPrice": "1.00",
                    "PayablePrice": "0.45",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.4c8g_cn-beijing",
                    "ChargeItemType": "Secondary",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "0.45",
                    "OriginalPrice": "1.00",
                    "PayablePrice": "0.45",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.1c2g_cn-beijing",
                    "ChargeItemType": "ReadOnly",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "0.11",
                    "OriginalPrice": "0.25",
                    "PayablePrice": "0.11",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.1c2g_cn-beijing",
                    "ChargeItemType": "ReadOnly",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "0.11",
                    "OriginalPrice": "0.25",
                    "PayablePrice": "0.11",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.localssd_cn-beijing",
                    "ChargeItemType": "Storage",
                    "ChargeItemValue": 100,
                    "DiscountPrice": "0.23",
                    "OriginalPrice": "0.50",
                    "PayablePrice": "0.23",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.proxy.rcu_cn-beijing",
                    "ChargeItemType": "Proxy",
                    "ChargeItemValue": 4,
                    "DiscountPrice": "0.1971",
                    "OriginalPrice": "0.438",
                    "PayablePrice": "0.1971",
                    "UnitPrice": ""
                }
            ],
            "CouponAmount": "",
            "Currency": "人民币",
            "DiscountPrice": "1.55",
            "OriginalPrice": "3.44",
            "PayablePrice": "1.55",
            "Quantity": 1,
            "RefundAmount": ""
        },
        "DiscountPrice": 1.55,
        "OriginalPrice": 3.44,
        "PayablePrice": 1.55,
        "Quantity": 1,
        "RefundAmount": 0
    }
}

请求示例 2

查询实例在预付费(包年包月)方式下的价格。

POST /?Action=DescribeDBInstancePriceDetail&Version=2022-01-01 HTTP/1.1
Accept: application/json
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****
{
    "StorageType": "LocalSSD",
    "StorageSpace": 100,
    "ChargeType": "PrePaid",
    "PeriodUnit": "Month",
    "Period": 2,
    "NodeInfo": [
        {
            "NodeSpec": "rds.mysql.4c8g",
            "NodeType": "Primary"
        },
        {
            "NodeSpec": "rds.mysql.4c8g",
            "NodeType": "Secondary"
        },
        {
            "NodeSpec": "rds.mysql.1c2g",
            "NodeType": "ReadOnly"
        },
        {
            "NodeSpec": "rds.mysql.1c2g",
            "NodeType": "ReadOnly"
        }
    ],
    "Number": 1,
    "ProxyNodeCustom": {
        "CpuNum": 4
    }
}

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "2025060611525303D5FB296DFA7FB77DD8-a8336d",
        "Action": "DescribeDBInstancePriceDetail",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing2"
    },
    "Result": {
        "DescribeDBInstancePriceDetailStr": {
            "BillingMethod": "fixed_price",
            "ChargeItemPrices": [
                {
                    "ChargeItemKey": "rds.mysql.d1.4c8g_cn-beijing",
                    "ChargeItemType": "Primary",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "720.00",
                    "OriginalPrice": "960.00",
                    "PayablePrice": "720.00",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.4c8g_cn-beijing",
                    "ChargeItemType": "Secondary",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "720.00",
                    "OriginalPrice": "960.00",
                    "PayablePrice": "720.00",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.1c2g_cn-beijing",
                    "ChargeItemType": "ReadOnly",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "180.00",
                    "OriginalPrice": "240.00",
                    "PayablePrice": "180.00",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.1c2g_cn-beijing",
                    "ChargeItemType": "ReadOnly",
                    "ChargeItemValue": 1,
                    "DiscountPrice": "180.00",
                    "OriginalPrice": "240.00",
                    "PayablePrice": "180.00",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.localssd_cn-beijing",
                    "ChargeItemType": "Storage",
                    "ChargeItemValue": 100,
                    "DiscountPrice": "360.00",
                    "OriginalPrice": "480.00",
                    "PayablePrice": "360.00",
                    "UnitPrice": ""
                },
                {
                    "ChargeItemKey": "rds.mysql.d1.proxy.rcu_cn-beijing",
                    "ChargeItemType": "Proxy",
                    "ChargeItemValue": 4,
                    "DiscountPrice": "0.1971",
                    "OriginalPrice": "0.438",
                    "PayablePrice": "0.1971",
                    "UnitPrice": ""
                }
            ],
            "CouponAmount": "0",
            "Currency": "",
            "DiscountPrice": "2160",
            "OriginalPrice": "2880",
            "PayablePrice": "2160",
            "Quantity": 1,
            "RefundAmount": ""
        },
        "DiscountPrice": 2160,
        "OriginalPrice": 2880,
        "PayablePrice": 2160,
        "Quantity": 1,
        "RefundAmount": 0
    }
}

错误码

更多详情,请参见错误码