创建边缘裸金属物理机
更新时间：2022-04-11
接口描述
本接口用于创建BEC裸金属物理机。
请求结构
POST /v1/bm HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"resourcePackageCode":"resourcePackageCode",
"name":"name",
"hostName":"hostName",
"deployInstances":[
{
"regionId": "regionId",
"region":"region",
"replicas":1,
"city":"city",
"serviceProvider":"serviceProvider"
}
],
"imageOs":"imageOs",
"paymentMethod":"paymentMethod",
"directPay":false,
"reservation":{
"length":1,
"timeUnit":"timeUnit"
},
"systemDiskType":"systemDiskType",
"systemDiskSizeInGb":480,
"rootDiskSizeInGb":200,
"keyConfig":{
"type":"type",
"bccKeyPairIdList":[
"bccKeyPairId"
]
}
}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| resourcePackageCode | String | 是 | RequestBody参数 | 套餐编号，通过规格套餐接口获取 |
| name | String | 否 | RequestBody参数 | 物理机名称（不传为随机名称，长度不超过64） |
| hostName | String | 否 | RequestBody参数 | 主机名（不传同物理机名称，长度不超过64） |
| deployInstances | List<DeploymentInstance> | 是 | RequestBody参数 | 部署区域 |
| imageOs | String | 是 | RequestBody参数 | 镜像操作系统名称，支持列表 |
| paymentMethod | String | 是 | RequestBody参数 | 支付方式（postpay：后付费；prepay：预付费） |
| directPay | Boolean | 否 | RequestBody参数 | 预付费直接扣款 |
| reservation | Reservation | 否 | RequestBody参数 | 预付费时长 |
| systemDiskType | BmDiskType | 是 | RequestBody参数 | 系统盘类型 |
| systemDiskSizeInGb | Integer | 是 | RequestBody参数 | 系统盘大小，单位GB（套餐磁盘列表中任选一系统盘） |
| rootDiskSizeInGb | Integer | 是 | RequestBody参数 | 根分区大小，单位GB（不小于50） |
| keyConfig | KeyConfig | 是 | RequestBody参数 | 密码或密钥配置 |
响应头域
除公共头域外，无其他特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | List<String> | 返回结果，后付费返回物理机ID，预付费返回订单ID |
| success | Boolean | 返回结果，true：表示为成功，false：表示为不成功 |
错误码
请参照错误返回章节的内容。
请求示例
POST /v1/bm HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"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"
}
],
"imageOs":"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。如果传regjionId，则可以不传region、serviceProvider、city。 |
| region | Region | 区域 |
| serviceProvider | ServiceProvider | 运营商 |
| city | String | 城市 |
| replicas | Integer | 副本数，最小为1 |
ServiceProvider
| 编码 | 描述 |
|---|---|
| CHINA_MOBILE | 中国移动 |
| CHINA_UNICOM | 中国联通 |
| CHINA_TELECOM | 中国电信 |
| TRIPLE_LINE | 三线 |
| INTRA | 内网 |
| BGP | 海外节点运营商BGP |
Reservation
| 参数名称 | 类型 | 描述 |
|---|---|---|
| length | Integer | 时长 |
| timeUnit | String | 单位 month:月 year:年 |
BmDiskType
| 编码 | 描述 |
|---|---|
| NVME_SSD | NVME_SSD |
| SATA_SSD | SATA_SSD |
| SATA_HDD | SATA_HDD |
KeyConfig
| 参数名称 | 类型 | 描述 |
|---|---|---|
| type | String | 类型，bccKeyPair为选择密钥对，password为选择的密码 |
| bccKeyPairIdList | List<String> | 密钥对ID列表 |
| adminPass | String | 密码限制长度为8～32位字符，英文、数字和符号必须同时存在，符号仅限!@#$%^+*() |
字段枚举
imageOs
| 枚举 | 备注 |
|---|---|
| centos7u6 | centos7u6 |
| centos70 | centos70 |
| 8 | centos8，目前传8 |
| centos6u10 | centos6u10 |
| centos6u9 | centos6u9 |
| debian10 | debian10 |
| debian9 | debian9 |
| xenial | ubuntu16.04 |
| bionic | ubuntu18.04 |
| focal | ubuntu20.04 |