新购分布式数据库实例询价
最近更新时间: 2024-10-18 10:38:30
1. 接口描述
接口请求域名： dcdb.api3.fincloud.tencent.cn。
本接口（DescribeDCDBPrice）用于在购买实例前，查询实例的价格。 注意：当前 TCE 上 Paymode 参数需要传 postpaid。
默认接口请求频率限制：20次/秒。
接口更新时间：2023-02-08 12:31:27。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeDCDBPrice |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-11 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| Zone | 是 | 否 | String | 欲新购实例的可用区ID。 |
| Count | 是 | 否 | Int64 | 欲购买实例的数量，目前支持购买1-10个实例 |
| Period | 是 | 否 | Int64 | 欲购买的时长，单位：月。不传时默认查询1个月的价格。付费模式为 postpaid 时该参数无效，固定查询第一计费阶梯使用1小时的费用。 |
| ShardNodeCount | 是 | 否 | Int64 | 单个分片节点个数大小，可以通过 DescribeShardSpec<br> 查询实例规格获得。 |
| ShardMemory | 是 | 否 | Int64 | 分片内存大小，单位：GB，可以通过 DescribeShardSpec<br> 查询实例规格获得。 |
| ShardStorage | 是 | 否 | Int64 | 分片存储空间大小，单位：GB，可以通过 DescribeShardSpec<br> 查询实例规格获得。 |
| ShardCount | 是 | 否 | Int64 | 实例分片个数，可选范围2-8，可以通过升级实例进行新增分片到最多64个分片。 |
| 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.SpecIdIllegal | |
| UnauthorizedOperation.PermissionDenied |