查询抢占实例市场价
更新时间：2026-06-22
本接口用于查询抢占实例市场价。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/instance/bidPrice HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "spec" : spec,
7 "rootDiskSizeInGb" : rootDiskSizeInGb,
8 "rootDiskStorageType" : rootDiskStorageType,
9 "createCdsList" : [
10 {
11 "storageType" : storageType,
12 "cdsSizeInGB" : cdsSizeInGB,
13 "cdsNum" : cdsNum,
14 "name" : name,
15 "cdsExtraIo" : cdsExtraIo,
16 "snapshotId" : snapshotId,
17 "encryptKey" : encryptKey,
18 "enableDeleteProtection" : enableDeleteProtection,
19 "deleteWithInstance" : deleteWithInstance,
20 "deleteAutoSnapshot" : deleteAutoSnapshot
21 }
22 ],
23 "networkCapacityInMbps" : networkCapacityInMbps,
24 "internetChargeType" : internetChargeType,
25 "purchaseCount" : purchaseCount,
26 "zoneName" : zoneName
27}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| spec | String | 是 | RequestBody参数 | 套餐 |
| rootDiskSizeInGb | int | 否 | RequestBody参数 | 待创建虚拟机实例的系统盘大小，单位GB，默认是40GB，范围为[40, 2048]GB，超过40GB按照云磁盘价格收费。注意指定的系统盘大小需要满足所使用镜像最小磁盘空间限制。 |
| rootDiskStorageType | String | 否 | RequestBody参数 | 待创建虚拟机实例系统盘介质，默认使用SSD型云磁盘，可指定系统盘磁盘类型可参见[StorageType](BCC/API参考/附录.md#StorageType |
| createCdsList | List<CreateCdsModel> | 否 | RequestBody参数 | 待创建的CDS磁盘列表，具体数据格式参见下述CreateCdsModel |
| networkCapacityInMbps | int | 否 | RequestBody参数 | 公网带宽，单位为Mbps。必须为0~200之间的整数，为0表示不分配公网IP，默认为0Mbps |
| internetChargeType | String | 否 | RequestBody参数 | 公网带宽计费方式，可选参数详见internetChargeType，若不指定internetChargeType，默认付费方式同BCC，预付费默认为包年包月按带宽，后付费默认为按使用带宽计费 |
| purchaseCount | int | 否 | RequestBody参数 | 批量创建（购买）的虚拟机实例个数，必须为大于0的整数，可选参数，缺省为1 |
| zoneName | String | 是 | RequestBody参数 | 指定zone信息，默认为空，由系统自动选择，可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a"。专属实例使用专属服务器所在zone,无需指定该字段。 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| money | String | 总价 |
| count | String | 购买个数 |
| originalMoney | String | 原价总价 |
| perOriginalMoney | String | 原价单价 |
| perMoney | String | 单个价格 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | invalid purchaseNum. | 400 | 购买数量需要大于0 |
| BadRequest | missing bcc config. | 400 | 缺少bcc配置 |
| BadRequest | invalid instanceType. | 400 | 无效的实例类型 |
| Instance.InvalidateZoneException | Invalidate zone name. | 400 | 无效的可用区 |
请求示例
Plain Text
1POST /v2/instance/bidPrice HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "spec": "bcc.g7.c2m8",
7 "zoneName": "cn-bj-d",
8 "createCdsList": [
9 {
10 "storageType": "std1",
11 "cdsSizeInGB": 5
12 }
13 ],
14 "purchaseCount": 1
15}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "money": "0.0011367",
9 "count": "1",
10 "perMoney": "0.0011367"
11}评价此篇文章