新购实例询价

最近更新时间: 2026-09-17 00:06:50

1. 接口描述

接口请求域名： mariadb.api3.fincloud.tencent.cn。

本接口（DescribePrice）用于在购买实例前，查询实例的价格。
注意：当前内部 Paymode 参数需要传 postpaid。

默认接口请求频率限制：20次/秒。

接口更新时间：2023-07-14 19:16:26。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribePrice
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Zone	是	否	String	欲新购实例的可用区ID。示例值： ap-region1-2
NodeCount	是	否	Int64	实例节点个数，可以通过 DescribeDBInstanceSpecs 查询实例规格获得。示例值： 2
Memory	是	否	Int64	内存大小，单位：GB，可以通过 DescribeDBInstanceSpecs 查询实例规格获得。示例值： 2000
Storage	是	否	Int64	存储空间大小，单位：GB，可以通过 DescribeDBInstanceSpecs 查询实例规格获得不同内存大小对应的磁盘规格下限和上限。示例值： 10000
Period	否	否	Int64	欲购买的时长，单位：月。不传时默认查询1个月的价格。付费模式为 postpaid 时该参数无效，固定查询第一计费阶梯使用1小时的费用。示例值： 1
Count	否	否	Int64	欲购买的数量，默认查询购买1个实例的价格。示例值： 1
Paymode	否	否	String	付费类型。postpaid：按量付费；prepaid：预付费。不传时默认为预付费（当前内部暂不支持预付费功能）示例值： prepaid
Cpu	否	否	Int64	CPU核数示例值： x86

3. 输出参数

参数名称	类型	描述
OriginalPrice	Int64	原价，单位：分示例值： 21120
Price	Int64	实际价格，单位：分。受折扣等影响，可能和原价不同。计量模式下返回值恒为0。示例值： 21120
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError.CamAuthFailed	CAM鉴权请求失败。
InternalError.QueryPriceFailed	查询价格失败。
InvalidParameter.GenericParameterError	参数合法性校验错误。
InvalidParameter.SpecNotFound	找不到对应的售卖规格。
InvalidParameterValue.IllegalCount	商品数量超出限制。
InvalidParameterValue.IllegalZone	未找到对应的可用区信息。
InvalidParameterValue.SpecIdIllegal	找不到数据库实例对应的规格信息。
UnauthorizedOperation.PermissionDenied	没有权限操作该接口或资源。

5. 示例

示例1 查询新购云数据库实例的价格

输入示例

https://mariadb.api3.fincloud.tencent.cn/?Action=DescribePrice
&NodeCount=2
&Memory=2000
&Storage=10000
&Zone=ap-region1-2
&Count=1
&Period=1
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "7e1000c2-190a-d0df-ff75-59fbdf5ff381",
        "OriginalPrice": 21120,
        "Price": 21120
    }
}