创建边缘裸金属物理机
更新时间：2025-09-19
接口描述
本接口用于创建BEC裸金属物理机。
请求结构
Plain Text
1POST /v1/bm HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
4
5{
6 "spec":"spec",
7 "name":"name",
8 "hostName":"hostName",
9 "deployInstances":[
10 {
11 "regionId": "regionId",
12 "networkType": "vpc",
13 "vpcId": "vpc-a1243lj",
14 "subnetId": "sbn-ou15jlg",
15 "replicas": 1
16 }
17 ],
18 "imageId":"imageId",
19 "paymentMethod":"paymentMethod",
20 "directPay":false,
21 "reservation":{
22 "length":1,
23 "timeUnit":"timeUnit"
24 },
25 "systemDiskType":"systemDiskType",
26 "systemDiskSizeInGb":480,
27 "rootDiskSizeInGb":200,
28 "keyConfig":{
29 "type":"type",
30 "bccKeyPairIdList":[
31 "bccKeyPairId"
32 ]
33 },
34 "cudaVersion": "cudaVersion",
35 "driverVersion": "driverVersion",
36 "cudnnVersion": "cudnnVersion"
37}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| spec | String | 是 | RequestBody参数 | 套餐规格，通过规格套餐接口获取 |
| name | String | 否 | RequestBody参数 | 物理机名称（不传为随机名称，长度不超过64） |
| hostName | String | 否 | RequestBody参数 | 主机名（不传同物理机名称，长度不超过64） |
| deployInstances | List<DeploymentInstance> | 是 | RequestBody参数 | 部署区域 |
| imageId | String | 是 | RequestBody参数 | 镜像ID |
| imageType | String | 是 | RequestBody参数 | 镜像类型。public：公共镜像，custom：自定义镜像 |
| paymentMethod | String | 是 | RequestBody参数 | 支付方式（postpay：后付费；prepay：预付费） |
| networkConfig | NetworkConfig | 是 | RequestBody参数 | 网络设置 |
| directPay | Boolean | 否 | RequestBody参数 | 预付费直接扣款 |
| reservation | Reservation | 否 | RequestBody参数 | 预付费时长 |
| autoRenew | AutoRenew | 否 | RequestBody参数 | 预付费自动续费 |
| systemDisk | BmDisk | 是 | RequestBody参数 | 系统盘 |
| rootDiskSizeInGb | Integer | 是 | RequestBody参数 | 根分区大小，单位GB（不小于50） |
| keyConfig | KeyConfig | 是 | RequestBody参数 | 密码或密钥配置 |
| cudaVersion | String | 否 | RequestBody参数 | CUDA 版本。linux平台，三位版本号；只适用于创建异构计算GPU裸金属物理机，开启自定义驱动安装时必填；注意：CUDA、Driver、cuDNN需要满足依赖关系 |
| driverVersion | String | 否 | RequestBody参数 | GPU驱动 版本。linux平台；只适用于创建异构计算GPU裸金属物理机，开启自定义驱动安装时必填；注意：CUDA、Driver、cuDNN需要满足依赖关系 |
| cudnnVersion | String | 否 | RequestBody参数 | cuDNN 版本。linux平台，三位版本号；只适用于创建异构计算GPU裸金属物理机，开启自定义驱动安装时必填；注意：CUDA、Driver、cuDNN需要满足依赖关系 |
响应头域
除公共头域外，无其他特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | List<String> | 返回结果，后付费返回物理机ID，预付费返回订单ID |
| success | Boolean | 返回结果，true：表示为成功，false：表示为不成功 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1POST /v1/bm HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
4
5{
6 "resourcePackageCode":"BEC-C-001",
7 "name":"bm-name",
8 "hostName":"bm-host-name",
9 "deployInstances":[
10 {
11 "regionId": "cn-hangzhou-cm",
12 "region":"EAST_CHINA",
13 "replicas":1,
14 "city":"HANGZHOU",
15 "serviceProvider":"CHINA_MOBILE"
16 }
17 ],
18 "imageId":"m-xxx-centos7u6",
19 "paymentMethod":"prepay",
20 "directPay":false,
21 "reservation":{
22 "length":1,
23 "timeUnit":"month"
24 },
25 "systemDiskType":"SATA_SSD",
26 "systemDiskSizeInGb":480,
27 "rootDiskSizeInGb":200,
28 "keyConfig":{
29 "type":"bccKeyPair",
30 "bccKeyPairIdList":[
31 "k-UL9abAx2"
32 ]
33 }
34}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6
7{
8 "result":[
9 "bm-ozlp82ft-1-m-hangzhou"
10 ],
11 "success":true
12}Model对象定义
DeploymentInstance
| 参数名称 | 类型 | 描述 |
|---|---|---|
| regionId | String | 节点ID，由“国家码-城市-运营商”的小写字母组成字符串。例如 cn-hangzhou-cm，其中国家码标准为ISO 3166-2，城市为拼音，运营商为中国移动cm/中国电信ct/中国联通un/三线ix/bgp。如果传regionId，则可以不传region、serviceProvider、city。 |
| replicas | Integer | 副本数，最小为1 |
| networkType | String | 是 |
| vpcId | String | 否 |
| subnetId | String | 否 |
ServiceProvider
| 编码 | 描述 |
|---|---|
| CHINA_MOBILE | 中国移动 |
| CHINA_UNICOM | 中国联通 |
| CHINA_TELECOM | 中国电信 |
| TRIPLE_LINE | 三线 |
| INTRA | 内网 |
| BGP | BGP |
NetworkConfig
| 参数名称 | 类型 | 描述 |
|---|---|---|
| needPublicIp | Boolean | 是否需要公网IPv4。true：需要，false：不需要 |
| needIpv6PublicIp | Boolean | 是否需要公网IPv6。true：需要，false：不需要 |
| networksList | List<Networks> | 网卡信息，包含Networks；用于设置对应的网卡名称。 |
Networks
| 参数名称 | 类型 | 描述 |
|---|---|---|
| type | String | 网卡类型 (枚举值：Ether) |
| netName | String | 网卡名称，内外网卡的名称不能重复，例如如xgbe0，xgbe1。 支持大小写字母，数字，"-_"，必须以字母开头，长度3-16字符。 |
Reservation
| 参数名称 | 类型 | 描述 |
|---|---|---|
| length | Integer | 时长 |
| timeUnit | String | 单位 month:月 year:年 |
AutoRenew
| 参数名称 | 类型 | 描述 |
|---|---|---|
| length | Integer | 预付费自动续费的续费时长 |
| timeUnit | String | 时间单位 year 或者 month |
BmDisk
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| name | String | 否 | 系统盘名称（不填为随机值） |
| volumeType | BmDiskType | 是 | 系统盘类型 |
| sizeInGb | Integer | 是 | 系统盘大小，单位GB |
BmDiskType
| 编码 | 描述 |
|---|---|
| NVME_SSD | NVME_SSD |
| SATA_SSD | SATA_SSD |
| SATA_HDD | SATA_HDD |
KeyConfig
| 参数名称 | 类型 | 描述 |
|---|---|---|
| type | String | 类型，bccKeyPair为选择密钥对，password为选择的密码 |
| bccKeyPairIdList | List<String> | bccKeyPair类型的密钥对ID列表 |
| adminPass | String | password类型的密码，限制长度为8～32位字符，英文、数字和符号必须同时存在，符号仅限!@#$%^+*() |