专属服务器创建
更新时间：2025-08-21
专属服务器创建
- 本接口用于创建一个或多个同配置的专属服务器。
请求结构
Plain Text
1POST /v{version}/dedicatedHost?clientToken={clientToken} HTTP/1.1
2Host: dcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "vCpu": vCpu, //cpu虚拟化核数
7 "name": "name", //专属服务器名称
8 "flavorName": "flavorName", //套餐类型："C01"
9 "purchaseCount": purchaseCount, //购买数目，最小1
10 "billing":{
11 "paymentTiming": paymentTiming, //付款时间，预付费(Prepaid)和后支付(Postid)
12 "reservation": {
13 "reservationLength": reservationLength //购买时长，最小1
14 }
15 },
16 "zoneName": zoneName //zone信息，默认为空
17}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串)。 |
| vCpu | int | 否 | RequestBody参数 | 待创建专属服务器虚拟CPU核数，数量不能超过物理CPU核数的两倍 |
| flavorName | String | 是 | RequestBody参数 | 套餐类型，可选计算型(calculation)C01/C02，可选大数据机型(storage)S01/S02 |
| purchaseCount | int | 否 | RequestBody参数 | 批量创建（购买）的虚专属服务器个数，必须为大于0的整数，可选参数，缺省为1 |
| name | String | 否 | RequestBody参数 | 专属服务器名字（可选）。默认都不指定name。如果指定name：批量时name作为名字的前缀。后端将加上后缀，后缀生成方式：name{ -序号}。如果没有指定name，则自动生成，方式：{instance-八位随机串-序号}。注：随机串从0~9a~z生成；序号按照count的数量级，依次递增，如果count为100，则序号从000~100递增，如果为10，则从00~10递增 |
| billing | Billing | 是 | RequestBody参数 | 订单、计费相关参数 |
| zoneName | String | 否 | RequestBody参数 | 指定zone信息，默认为空，由系统自动选择 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| dedicatedHostIds | List<String> | 专属服务器ID的集合，其中ID符合BCE规范，必须是一个定长字符串，且只允许包含大小写字母、数字、连字号（-）和下划线（_）。 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| dedicatedHost.dedicatedHostBeBanned | The dedicatedHost is banned, contact technical support for assistance. | 403 | DCC服务已被封禁 |
| dedicatedHost.GlobalhostQuotaLimitExceeded | Quota exceeds limit for regional prepaid dedicatedHost pool, contact technical support for further assistance. | 413 | 预付费类型的专属服务器数目超出当前区域预售额度限制 |
| dedicatedHost.dedicatedHostQuotaLimitExceeded | Quota exceeds limit. | 413 | 专属服务器个数超过限制 |
请求示例
Plain Text
1POST /v1/dedicatedHost?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: dcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "vCpu": 22, //cpu虚拟化核数
8 "flavorName": "C01", //套餐配置："C01"
9 "purchaseCount": 1, //购买数目，最小1
10 "billing":{
11 "paymentTiming": "prepaid", //付款时间，预付费(Prepaid)和后支付(Postid)
12 "reservation": {
13 "reservationLength": 1 //购买时长，最小1
14 }
15 }
16}返回示例
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 "dedicatedHostIds": [
9 "d-qw2Pf3wB"
10 ]
11}