创建边缘裸金属物理机
更新时间: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位字符,英文、数字和符号必须同时存在,符号仅限!@#$%^+*() |