新购实例询价
最近更新时间: 2024-10-18 10:38:32
1. 接口描述
接口请求域名： mariadb.api3.fincloud.tencent.cn。
本接口（DescribePrice）用于在购买实例前，查询实例的价格。 注意：当前 TCE 上 Paymode 参数需要传 postpaid。
默认接口请求频率限制：20次/秒。
接口更新时间：2023-02-08 15:39:33。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribePrice |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| Zone | 是 | 否 | String | 欲新购实例的可用区ID。 |
| NodeCount | 是 | 否 | Int64 | 实例节点个数，可以通过 DescribeDBInstanceSpecs<br> 查询实例规格获得。 |
| Memory | 是 | 否 | Int64 | 内存大小，单位：GB，可以通过 DescribeDBInstanceSpecs<br> 查询实例规格获得。 |
| Storage | 是 | 否 | Int64 | 存储空间大小，单位：GB，可以通过 DescribeDBInstanceSpecs<br> 查询实例规格获得不同内存大小对应的磁盘规格下限和上限。 |
| Period | 否 | 否 | Int64 | 欲购买的时长，单位：月。不传时默认查询1个月的价格。付费模式为 postpaid 时该参数无效，固定查询第一计费阶梯使用1小时的费用。 |
| Count | 否 | 否 | Int64 | 欲购买的数量，默认查询购买1个实例的价格。 |
| Paymode | 否 | 否 | String | 付费类型。postpaid：按量付费；prepaid：预付费。不传时默认为预付费（当前TCE暂不支持预付费功能） |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| OriginalPrice | Int64 | 原价，单位：分 |
| Price | Int64 | 实际价格，单位：分。受折扣等影响，可能和原价不同。计量模式下返回值恒为0。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.CamAuthFailed | |
| InternalError.QueryPriceFailed | |
| InvalidParameter.GenericParameterError | |
| InvalidParameter.SpecNotFound | |
| InvalidParameterValue.IllegalCount | |
| InvalidParameterValue.IllegalZone | |
| InvalidParameterValue.SpecIdIllegal | |
| UnauthorizedOperation.PermissionDenied |