创建抢占实例
更新时间:2026-06-22
本接口用于创建抢占实例。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,免去您计算签名的困扰。运行成功后,API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/instanceBySpec HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "spec" : spec,
7 "imageId" : imageId,
8 "billing" : {
9 "paymentTiming" : paymentTiming,
10 "reservation" : {
11 "reservationLength" : reservationLength,
12 "reservationTimeUnit" : reservationTimeUnit
13 }
14 },
15 "bidModel" : bidModel,
16 "bidPrice" : bidPrice,
17 "cpuCount" : cpuCount,
18 "memoryCapacityInGB" : memoryCapacityInGB,
19 "rootDiskSizeInGb" : rootDiskSizeInGb,
20 "rootDiskStorageType" : rootDiskStorageType,
21 "createCdsList" : [
22 {
23 "storageType" : storageType,
24 "cdsSizeInGB" : cdsSizeInGB,
25 "cdsNum" : cdsNum,
26 "name" : name,
27 "cdsExtraIo" : cdsExtraIo,
28 "snapshotId" : snapshotId,
29 "encryptKey" : encryptKey,
30 "enableDeleteProtection" : enableDeleteProtection,
31 "deleteWithInstance" : deleteWithInstance,
32 "deleteAutoSnapshot" : deleteAutoSnapshot
33 }
34 ],
35 "ephemeralDisks" : [
36 {
37 "storageType" : storageType,
38 "sizeInGB" : sizeInGB,
39 "freeSizeInGB" : freeSizeInGB
40 }
41 ],
42 "networkCapacityInMbps" : networkCapacityInMbps,
43 "internetChargeType" : internetChargeType,
44 "eipName" : eipName,
45 "purchaseCount" : purchaseCount,
46 "name" : name,
47 "hostname" : hostname,
48 "autoSeqSuffix" : autoSeqSuffix,
49 "isOpenHostnameDomain" : isOpenHostnameDomain,
50 "adminPass" : adminPass,
51 "keypairId" : keypairId,
52 "userData" : userData,
53 "zoneName" : zoneName,
54 "subnetId" : subnetId,
55 "securityGroupId" : securityGroupId,
56 "enterpriseSecurityGroupId" : enterpriseSecurityGroupId,
57 "isomerismCard" : isomerismCard,
58 "deletionProtection" : deletionProtection,
59 "relationTag" : relationTag,
60 "isOpenIpv6" : isOpenIpv6,
61 "tags" : [
62 {
63 "tagKey" : tagKey,
64 "tagValue" : tagValue
65 }
66 ],
67 "aspId" : aspId,
68 "fileSystems" : [
69 {
70 "fsId" : fsId,
71 "mountAds" : mountAds,
72 "path" : path,
73 "protocol" : protocol
74 }
75 ],
76 "isEipAutoRelatedDelete" : isEipAutoRelatedDelete,
77 "resGroupId" : resGroupId
78}
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本 |
| spec | String | 是 | RequestBody参数 | 实例规格 |
| imageId | String | 是 | RequestBody参数 | 镜像ID |
| billing | Billing | 是 | RequestBody参数 | 订单、计费相关参数 |
| bidModel | String | 是 | RequestBody参数 | 抢占实例出价模型,市场价: market,自定义: custom |
| bidPrice | String | 否 | RequestBody参数 | 抢占实例出价金额,单位:元/分钟。当bidModel=custom时有效 |
| cpuCount | int | 否 | RequestBody参数 | CPU核数 |
| memoryCapacityInGB | int | 否 | RequestBody参数 | 内存容量,单位GB |
| rootDiskSizeInGb | int | 否 | RequestBody参数 | 系统盘大小,单位GB,默认40,范围[40, 2048] |
| rootDiskStorageType | String | 否 | RequestBody参数 | 系统盘介质类型 |
| createCdsList | List<CreateCdsModel> | 否 | RequestBody参数 | 待创建的CDS磁盘列表 |
| ephemeralDisks | List<EphemeralDisk> | 否 | RequestBody参数 | 本地盘列表 |
| networkCapacityInMbps | int | 否 | RequestBody参数 | 公网带宽,单位Mbps,0~200,0表示不分配公网IP |
| internetChargeType | String | 否 | RequestBody参数 | 公网带宽计费方式 |
| eipName | String | 否 | RequestBody参数 | EIP名称 |
| purchaseCount | int | 否 | RequestBody参数 | 批量创建的实例个数,默认为1 |
| name | String | 否 | RequestBody参数 | 虚拟机名字,批量时作为前缀 |
| hostname | String | 否 | RequestBody参数 | 虚拟机主机名 |
| autoSeqSuffix | Boolean | 否 | RequestBody参数 | 是否自动生成name和hostname有序后缀 |
| isOpenHostnameDomain | Boolean | 否 | RequestBody参数 | 是否自动生成hostname domain |
| adminPass | String | 否 | RequestBody参数 | 实例管理员密码,需加密传输 |
| keypairId | String | 否 | RequestBody参数 | 密钥对ID |
| userData | String | 否 | RequestBody参数 | 用户自定义数据,Base64编码 |
| zoneName | String | 否 | RequestBody参数 | 可用区名称,如cn-bj-a |
| subnetId | String | 否 | RequestBody参数 | 子网ID |
| securityGroupId | String | 否 | RequestBody参数 | 安全组ID |
| enterpriseSecurityGroupId | String | 否 | RequestBody参数 | 企业安全组ID |
| isomerismCard | String | 否 | RequestBody参数 | 异构卡信息 |
| deletionProtection | int | 否 | RequestBody参数 | 实例释放保护,0未开启,1开启 |
| relationTag | Boolean | 否 | RequestBody参数 | 标签是否需要和已有标签键进行关联 |
| isOpenIpv6 | Boolean | 否 | RequestBody参数 | 是否开启ipv6 |
| tags | List<TagModel> | 否 | RequestBody参数 | 标签列表 |
| aspId | String | 否 | RequestBody参数 | 自动快照策略ID |
| fileSystems | List<FileSystemModel> | 否 | RequestBody参数 | 挂载文件存储CFS列表 |
| isEipAutoRelatedDelete | Boolean | 否 | RequestBody参数 | 后付费EIP是否随抢占实例关联自动释放 |
| resGroupId | String | 否 | RequestBody参数 | 资源组ID |
返回头域
除公共头域,无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| orderId | String | 订单ID |
| instanceIds | List<String> | 虚机实例ID的集合,其中ID符合BCE规范,必须是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)。 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| Instance.InsufficientRootDiskSize | Not enough root disk size. | 400 | 使用镜像过大,系统盘大小不够 |
| Instance.InvalidateRootDiskStorageType | Invalidate root disk storage type. | 400 | 无效的系统盘介质 |
| Instance.InvalidateConfiguration | Invalidate cpu memory configuration. | 400 | 无效的虚机配置 |
| BadRequest | bid price should be greater than market price. | 400 | 抢占实例自定义出价应大于市场价 |
| BadRequest | invalid purchaseNum. | 400 | 购买数量需要大于0 |
| BadRequest | missing bcc config. | 400 | 缺少bcc配置 |
| BadRequest | invalid instanceType. | 400 | 无效的实例类型 |
| BadRequest | bidPrice can not be null when bidModel is custom. | 400 | 自定义出价时bidPrice不能为空 |
| BadRequest | bidModel is invalid. | 400 | bidModel的值无效 |
| BadRequest | bidPrice is invalid. | 400 | bidPrice的值无效 |
| BadRequest | Not support serviceType. | 400 | 不支持该服务类型 |
| BadRequest | cds config error. | 400 | cds配置错误 |
| Instance.InstanceCountCdsCountNotMatchException | Cds count must be multiple number of Instance count | 400 | 创建的虚机数量和cds数量不匹配 |
| Instance.InvalidateZoneException | Invalidate zone name. | 400 | 无效的可用区 |
| BadRequest | Not support serviceType | 400 | 不支持该服务类型 |
| BadRequest | invalid deploy id | 400 | 无效的部署集ID |
| BadRequest | invalid cds count | 400 | cds 数量应该是bcc的整数倍 |
| BadRequest | cannot get market price | 400 | 不能够获得市场价 |
| Instance.PermissionDeny | Instance permission deny. permission deny | 401 | 无权限 |
| Instance.InstanceBeBanned | The instance is banned, contact technical support for assistance. | 403 | Bcc服务已被封禁 |
| Instance.RegionDenyException | You're not allowed to access this region. | 403 | region拒绝访问异常. |
| Instance.NotSupportInstanceTypeException | not support the instance type. | 403 | 不支持该机型 |
| RealNameQualify | No real name authentication | 409 | 不可操作,未实名认证 |
| Instance.GlobalInstanceQuotaLimitExceeded | Quota exceeds limit for regional postpaid instances pool, contact technical support for further assistance. | 413 | 后付费类型的虚机数目超出当前区域预售额度限制 |
| Instance.InstanceQuotaLimitExceeded | Quota exceeds limit. | 413 | 实例个数超过限制 |
| Instance.EipQuotaLimitExceeded | The number of eip will exceed the limit. | 413 | 合并购买时eip个数超过限制 |
请求示例
Plain Text
1POST /v2/instanceBySpec 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.g3.c4m12",
7 "bidModel": "custom",
8 "bidPrice": 0.01,
9 "createCdsList": [
10 {
11 "storageType": "std1",
12 "cdsSizeInGB": 5
13 }
14 ],
15 "name": "example",
16 "imageId": "m-mRjO3cjs",
17 "networkCapacityInMbps": 0,
18 "purchaseCount": 1,
19 "billing": {
20 "paymentTiming": "Bidding",
21 "reservation": {
22 "reservationLength": 1
23 }
24 }
25}
返回示例
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 "orderId": "d1ace996973643b299ea506a80dae4da",
9 "instanceIds": [
10 "i-T1I3OtUO"
11 ]
12}
评价此篇文章
