创建实例（通过指定实例套餐规格）

更新时间：2026-06-22

前提条件

创建实例需要实名认证，没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的个人认证或企业认证中进行认证。

BCC实例

计费注意事项：
- 创建计费方式为后付费的实例需要账户现金余额+通用代金券大于100；预付费方式的实例则需要账户现金余额大于等于实例费用。
- 指定公网IP带宽创建，计费方式为按照带宽计费。
实例注意事项：
- 通过spec字段指定需要创建的虚机类型，通过实例套餐规格列表接口来查看可使用实例套餐及套餐规格。
- 同一实例不可以同时购买GPU卡和FPGA卡，购买带有GPU卡或FPGA卡的实例时必须通过cardCount指定要购买的虚机所携带的GPU卡或FPGA卡数量。
存储注意事项：
- 创建实例时可以指定系统盘大小，若是Linux，指定系统盘大小范围为[10, 2048]GB，若是Windows，指定系统盘大小范围为[40, 2048]GB，可指定系统盘磁盘类型可参见StorageType。
- 创建实例时添加的系统盘在创建之后无法更改，且不支持单独创建或添加系统盘。
- 系统盘不支持挂载、卸载、删除。
- 创建CDS系统盘和数据盘时，支持按照1GB步长选择磁盘大小。
- 一个实例挂载云磁盘数量与实例规格挂钩，具体限制请见使用限制。
- BCC实例的系统盘最大不能超过2T。
网络注意事项：
- BCC实例支持用户自定义安全组和子网，两者需要同时指定在同一个VPC下。如果未指定安全组和子网，在创建专属实例时会自动加入系统默认的安全组和子网内。
其他注意事项：
- 支持批量创建，且如果创建过程中有一个实例创建失败，所有实例将全部回滚，均创建失败，如果创建时包含CDS，CDS也会回滚。
- 创建接口为异步创建，可通过查询指定实例详情接口查询实例状态。

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    "keepImageLogin" : keepImageLogin,
7    "bccCreateWithScript" : bccCreateWithScript,
8    "name" : name,
9    "cpuThreadConfig" : cpuThreadConfig,
10    "numaConfig" : numaConfig,
11    "enableDeleteProtection" : enableDeleteProtection,
12    "hostname" : hostname,
13    "autoSeqSuffix" : autoSeqSuffix,
14    "isOpenHostnameDomain" : isOpenHostnameDomain,
15    "adminPass" : adminPass,
16    "keypairId" : keypairId,
17    "aspId" : aspId,
18    "specId" : specId,
19    "enableJumboFrame" : enableJumboFrame,
20    "userData" : userData,
21    "deletionProtection" : deletionProtection,
22    "autoRenewTimeUnit" : autoRenewTimeUnit,
23    "autoRenewTime" : autoRenewTime,
24    "hosteyeType" : hosteyeType,
25    "enableNuma" : enableNuma,
26    "enableHt" : enableHt,
27    "dataPartitionType" : dataPartitionType,
28    "rootPartitionType" : rootPartitionType,
29    "cdsAutoRenew" : cdsAutoRenew,
30    "createCdsList" : [
31        {
32            "storageType" : storageType,
33            "cdsSizeInGB" : cdsSizeInGB,
34            "cdsNum" : cdsNum,
35            "name" : name,
36            "cdsExtraIo" : cdsExtraIo,
37            "snapshotId" : snapshotId,
38            "encryptKey" : encryptKey,
39            "enableDeleteProtection" : enableDeleteProtection,
40            "deleteWithInstance" : deleteWithInstance,
41            "deleteAutoSnapshot" : deleteAutoSnapshot
42        }
43    ],
44    "imageId" : imageId,
45    "spec" : spec,
46    "roleName" : roleName,
47    "bidModel" : bidModel,
48    "bidPrice" : bidPrice,
49    "rootDiskSizeInGb" : rootDiskSizeInGb,
50    "rootDiskExtraIo" : rootDiskExtraIo,
51    "rootDiskStorageType" : rootDiskStorageType,
52    "networkCapacityInMbps" : networkCapacityInMbps,
53    "ehcClusterId" : ehcClusterId,
54    "purchaseCount" : purchaseCount,
55    "purchaseMinCount" : purchaseMinCount,
56    "billing" : {
57        "paymentTiming" : paymentTiming,
58        "reservation" : {
59            "reservationLength" : reservationLength,
60            "reservationTimeUnit" : reservationTimeUnit
61        }
62    },
63    "dedicatedHostId" : dedicatedHostId,
64    "relationTag" : relationTag,
65    "isOpenIpv6" : isOpenIpv6,
66    "tags" : [
67        {
68            "tagKey" : tagKey,
69            "tagValue" : tagValue
70        }
71    ],
72    "fileSystems" : [
73        {
74            "fsId" : fsId,
75            "mountAds" : mountAds,
76            "path" : path,
77            "protocol" : protocol
78        }
79    ],
80    "ephemeralDisks" : [
81        {
82            "storageType" : storageType,
83            "sizeInGB" : sizeInGB,
84            "freeSizeInGB" : freeSizeInGB
85        }
86    ],
87    "securityGroupId" : securityGroupId,
88    "enterpriseSecurityGroupId" : enterpriseSecurityGroupId,
89    "securityGroupIds" : [securityGroupId],
90    "enterpriseSecurityGroupIds" : [enterpriseSecurityGroupId],
91    "subnetId" : subnetId,
92    "deployId" : deployId,
93    "deployIdList" : [deployIdList],
94    "eniIds" : [eniId],
95    "disableRootDiskSerial" : disableRootDiskSerial,
96    "zoneName" : zoneName,
97    "internalIps" : [internalIp],
98    "resGroupId" : resGroupId,
99    "isEipAutoRelatedDelete" : isEipAutoRelatedDelete,
100    "isOpenHostEye" : isOpenHostEye,
101    "networkPurchaseType" : networkPurchaseType,
102    "instanceType" : instanceType,
103    "internetChargeType" : internetChargeType,
104    "eipName" : eipName
105}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
keepImageLogin	Boolean	否	RequestBody参数	是否使用镜像预设的密码，默认取值：false。true：表示使用镜像中预设的密码; false：表示不使用镜像中预设的密码。 1. 若取值为“true”，则password、keypairId需为空。 2. 仅支持镜像为自定义镜像或共享镜像。
bccCreateWithScript	String	否	RequestBody参数	在创建BCC实例时执行的自动化脚本
name	String	否	RequestBody参数	虚拟机名字（可选）。默认都不指定name。如果指定name：批量时name作为名字的前缀。后端将加上后缀，后缀生成方式：name{ -序号}。如果没有指定name，则自动生成，方式：{instance-八位随机串-序号}。注：随机串从0~9a~z生成；序号按照count的数量级，依次递增，如果count为100，则序号从000~100递增，如果为10，则从00~10递增。支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65。
cpuThreadConfig	String	否	RequestBody参数	调整每物理核的线程数（vCPU），本质上对应各处理器的超线程能力是否启用。取值范围：1、2 注意： 1. 默认情况下，百度智能云实例按照默认值2配置。 2. 仅Intel第七代以上、AMD第三代以上的裸金属实例规格支持设置 CPU 线程数。
numaConfig	String	否	RequestBody参数	调整CPU的NUMA配置，对于不同处理器平台取值有不同含义。 1. Intel平台：0代表关闭NUMA特性，1代表开启NUMA特性。 2. AMD平台：主要影响NPS(Nodes Per Socket)的配置，可取值0、1、2、4、auto，分别对应NPS0、NPS1、NPS2、NPS4以及自动。注意： 1. 默认情况下，百度智能云实例按照开启NUMA优化（Intel实例）、NPS1（AMD实例），也即默认值1配置。 2. 仅Intel第七代以上、AMD第三代以上的裸金属实例规格支持设置NUMA选项。
enableDeleteProtection	Boolean	否	RequestBody参数	是否开启删除保护功能
hostname	String	否	RequestBody参数	虚拟机主机名（可选）。默认都不指定hostname。如果指定hostname：批量时hostname作为名字的前缀。后端将加上后缀，后缀生成方式：name{ -序号}。如果没有指定name，则自动生成，方式：{instance-八位随机串-序号}。注：随机串从0~9a~z生成；序号按照count的数量级，依次递增，如果count为100，则序号从000~100递增，如果为10，则从00~10递增。仅支持小写字母、数字以及- . 特殊字符，必须以字母开头，不可连续使用特殊符号，不支持特殊符号开头或结尾，长度2-64
autoSeqSuffix	Boolean	否	RequestBody参数	是否自动生成name和hostname有序后缀（可选参数）是:true 否:false
isOpenHostnameDomain	Boolean	否	RequestBody参数	是否自动生成hostname domain（可选参数）是:true 否:false
adminPass	String	否	RequestBody参数	待指定的实例管理员密码，8-32位字符，大写字母、小写字母、数字、特殊符号至少存在三种，符号仅限()`~!@#$%^&*-_+=\|{}[]:;'<>,.?/，密码需要加密传输
keypairId	String	否	RequestBody参数	待创建实例所要绑定的密钥对ID
aspId	String	否	RequestBody参数	自动快照策略ID
specId	String	否	RequestBody参数	规格族
enableJumboFrame	Boolean	否	RequestBody参数	是否开启Jumbo帧，默认值false，开启:true，关闭:false。注意:只有支持Jumbo帧的套餐才能开启
userData	String	否	RequestBody参数	若实例满足使用实例自定义数据的限制，您可传入UserData信息。因为传输API请求时，不会加密您设置的UserData，建议不要以明文方式传入机密的信息，例如密码和私钥等。如果必须传入，建议加密后，然后以Base64的方式编码后再传入，在实例内部以同样的方式反解密。
deletionProtection	String	否	RequestBody参数	实例释放保护，默认0未开启，1开启，开启后禁止手动释放虚机
autoRenewTimeUnit	String	否	RequestBody参数	若开启自动续费，则需传值，不开启为空。按月付费或者按年付费月是"month",年是"year"
autoRenewTime	int	否	RequestBody参数	若开启自动续费，则需传值，不开启为空。自动续费的时间按月是1-9 按年是 1-5
hosteyeType	String	否	RequestBody参数	主机安全类型，isOpenHostEye为true时生效； "enterprise"，表示开启企业版主机安全；“open”或不传，表示开启基础版主机安全
enableNuma	Boolean	否	RequestBody参数	控制是否启用NUMA优化功能
enableHt	Boolean	否	RequestBody参数	是否开启Ht,ebc使用，默认值true, true:开启，false:关闭
dataPartitionType	String	否	RequestBody参数	数据盘文件格式,可选值：xfs，ext4
rootPartitionType	String	否	RequestBody参数	系统盘文件格式,可选值：xfs，ext4
cdsAutoRenew	Boolean	否	RequestBody参数	【此参数废弃，cds自动续费和bcc保持一致】cds是否自动续费是:true 否:false
createCdsList	List<CreateCdsModel>	否	RequestBody参数	待创建的CDS磁盘列表
imageId	String	是	RequestBody参数	待创建虚拟机实例的镜像ID，可通过调用查询镜像列表接口选择获取所需镜像ID。
spec	String	是	RequestBody参数	待创建虚拟机实例的套餐规格例bcc.g7.c2m8，通过使用实例套餐规格列表接口来查看可使用实例套餐及套餐规格。
roleName	String	否	RequestBody参数	角色名称
bidModel	String	否	RequestBody参数	抢占实例出价模型，市场价: "market" 自定义："custom"。参考BidModel
bidPrice	String	否	RequestBody参数	抢占实例出价金额，单位：元/分钟。若是自定义出价，且出价金额小于市场价，则不允许创建。当bidModel='custom'时才有效。
rootDiskSizeInGb	int	否	RequestBody参数	待创建虚拟机实例的系统盘大小，单位GB，Linux默认是20GB，范围为[10,2048]GB,Windows默认是40GB，范围为[40, 2048]GB。注意指定的系统盘大小需要满足所使用镜像最小磁盘空间限制。
rootDiskExtraIo	String	否	RequestBody参数	配置根磁盘的额外IO性能
rootDiskStorageType	String	否	RequestBody参数	待创建虚拟机实例系统盘介质，默认使用高性能云磁盘（hp1），可指定系统盘磁盘类型可参见StorageType。
networkCapacityInMbps	int	否	RequestBody参数	公网带宽，单位为Mbps。对于包年包月以及按使用带宽计费的后付费EIP，标准型BGP限制为1~500之间的整数，增强型BGP限制为100~5000之间的整数（代表带宽上限）；对于按使用流量计费的后付费EIP，标准型BGP限制为1~200之间的整数（代表允许的带宽流量峰值），为0表示不分配公网IP，默认为0Mbps
ehcClusterId	String	否	RequestBody参数	创建roce实例时可选参数，若为空则使用默认EHC集群
purchaseCount	int	否	RequestBody参数	批量创建（购买）的虚拟机实例个数，必须为大于0的整数，可选参数，缺省为1
purchaseMinCount	int	否	RequestBody参数	批量创建（购买）的虚拟机实例最小个数
billing	Billing	是	RequestBody参数	订单详情
dedicatedHostId	String	否	RequestBody参数	专属服务器id，指定虚机置放位置时指定该值。
relationTag	Boolean	否	RequestBody参数	其关联资源CDS（数据盘）、EIP、快照、快照链是否统一加标签，默认为false。
isOpenIpv6	Boolean	否	RequestBody参数	待创建实例是否开启ipv6，只有当镜像和子网都支持ipv6时才可开启，true表示开启，false表示关闭，不传表示自动适配镜像和子网的ipv6支持情况
tags	List<TagModel>	否	RequestBody参数	待创建的标签列表
fileSystems	List<FileSystemModel>	否	RequestBody参数	指定实例要挂载的cfs文件系统列表
ephemeralDisks	List<EphemeralDisk>	否	RequestBody参数	DCC实例可以创建多块本地盘，需要指定磁盘类型以及大小。其他类型BCC最多只能使用一块本地盘，使用默认磁盘类型，需要指定磁盘大小。FPGA实例以及GPU实例默认使用一块本地磁盘，根据配置指定本地盘大小
securityGroupId	String	否	RequestBody参数	已废弃，指定securityGroup信息，为空时将使用默认安全组
enterpriseSecurityGroupId	String	否	RequestBody参数	指定企业安全组
securityGroupIds	List<String>	否	RequestBody参数	指定securityGroup信息列表，为空时将使用默认安全组
enterpriseSecurityGroupIds	List<String>	否	RequestBody参数	指定企业安全组信息列表，不为空时，securityGroupIds无效，为空时将使用默认安全组
subnetId	String	否	RequestBody参数	指定subnet信息，为空时将使用默认子网
deployId	String	否	RequestBody参数	指定实例所在的部署集id
deployIdList	List<String>	否	RequestBody参数	指定实例所在的部署集id列表
eniIds	List<String>	否	RequestBody参数	待挂载的弹性网卡短ID列表。批量创建时会根据传入数量平均分配到实例上，所以请保证传入的弹性网卡id数量是实例数量的整数倍，且每个实例分配的eni数量不超过实例能挂载的最大数量。ebc裸金属实例暂不支持。eniIds数量最大为5000。
disableRootDiskSerial	String	否	RequestBody参数	创建实例时是否隐藏系统盘SN,默认false。 true:隐藏 fase:不隐藏
zoneName	String	是	RequestBody参数	指定zone信息，可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a"。专属实例使用专属服务器所在zone,无需指定该字段。
internalIps	List<String>	否	RequestBody参数	内网IP列表
resGroupId	String	否	RequestBody参数	指定实例要绑定的资源组id
isEipAutoRelatedDelete	Boolean	否	RequestBody参数	实例绑定的后付费EIP是否随实例关联自动释放，是：true，否：false，不传默认为false。仅当公网带宽计费方式为按使用带宽/流量计费时，该参数才生效。
isOpenHostEye	Boolean	否	RequestBody参数	是否开启主机安全，true:开启，false：关闭；不传默认开启
networkPurchaseType	String	否	RequestBody参数	EIP线路类型，包含标准BGP（BGP）和增强BGP（BGP_S），默认标准BGP
instanceType	String	否	RequestBody参数	待创建虚拟机实例的类型，具体可选类型参见InstanceType，为空时使用默认虚机类型
internetChargeType	String	否	RequestBody参数	公网带宽计费方式，可选参数详见internetChargeType，若不指定internetChargeType，默认付费方式同BCC，预付费默认为包年包月按带宽，后付费默认为按使用带宽计费。
eipName	String	否	RequestBody参数	公网IP名称，长度1～65个字节，字母开头，可包含字母数字-_/.字符。若不传该参数，服务会自动生成name。

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
orderId	String	订单ID
instanceIds	List<String>	虚机实例ID的集合，其中ID符合BCE规范，必须是一个定长字符串，且只允许包含大小写字母、数字、连字号（-）和下划线（_）
warningList	List<String>	创建虚机产生的warning信息

错误码

错误码	错误描述	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	spec is invalid.	400	待创建虚拟机实例的套餐规格参数无效
Instance.MKTImageInstanceNotSupportCreateSnapshotException	Instance with mkt image not support create system snapshot.	400	云市场镜像不支持创建系统快照
Instance.InstanceBeBanned	The instance is banned, contact technical support for assistance.	403	Bcc服务已被封禁
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.g7.c2m8",
7    "zoneName": "cn-bj-f",
8    "billing": {
9        "paymentTiming": "Prepaid",
10        "reservation": {
11            "reservationLength": 1,
12            "reservationTimeUnit": 12,
13            "createCdsList": [
14                {
15                    "storageType": "hp1",
16                    "cdsSizeInGB": 50
17                }
18            ],
19            "name": "example",
20            "imageId": "m-h4rTECpU",
21            "networkCapacityInMbps": 0,
22            "purchaseCount": 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    "instanceIds": [
9        "i-T1I3OtUO"
10    ],
11    "warningList": [
12        "warning info"
13    ]
14}

评价此篇文章

有帮助没帮助

错误返回

查询实例列表

百度智能云

云服务器 BCC

云服务器 BCC

创建实例（通过指定实例套餐规格）