创建边缘裸金属物理机
更新时间：2025-01-07
接口描述
本接口用于创建BEC裸金属物理机。
请求结构
POST /v1/bm HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"spec":"spec",
"name":"name",
"hostName":"hostName",
"deployInstances":[
{
"regionId": "regionId",
"networkType": "vpc",
"vpcId": "vpc-a1243lj",
"subnetId": "sbn-ou15jlg",
"replicas": 1
}
],
"imageId":"imageId",
"paymentMethod":"paymentMethod",
"directPay":false,
"reservation":{
"length":1,
"timeUnit":"timeUnit"
},
"systemDiskType":"systemDiskType",
"systemDiskSizeInGb":480,
"rootDiskSizeInGb":200,
"keyConfig":{
"type":"type",
"bccKeyPairIdList":[
"bccKeyPairId"
]
},
"cudaVersion": "cudaVersion",
"driverVersion": "driverVersion",
"cudnnVersion": "cudnnVersion"
}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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参数 | 预付费自动续费 |
| couponIds | List<String> | 否 | RequestBody参数 | 预付费代金券ID列表 |
| 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：表示为不成功 |
错误码
请参照错误返回章节的内容。
请求示例
POST /v1/bm HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"resourcePackageCode":"BEC-C-001",
"name":"bm-name",
"hostName":"bm-host-name",
"deployInstances":[
{
"regionId": "cn-hangzhou-cm",
"region":"EAST_CHINA",
"replicas":1,
"city":"HANGZHOU",
"serviceProvider":"CHINA_MOBILE"
}
],
"imageId":"m-xxx-centos7u6",
"paymentMethod":"prepay",
"directPay":false,
"reservation":{
"length":1,
"timeUnit":"month"
},
"systemDiskType":"SATA_SSD",
"systemDiskSizeInGb":480,
"rootDiskSizeInGb":200,
"keyConfig":{
"type":"bccKeyPair",
"bccKeyPairIdList":[
"k-UL9abAx2"
]
}
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"result":[
"bm-ozlp82ft-1-m-hangzhou"
],
"success":true
}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位字符，英文、数字和符号必须同时存在，符号仅限!@#$%^+*() |