创建BEC虚机服务
更新时间：2020-08-04
创建BEC虚机服务
接口描述
创建BEC虚机服务
请求结构
POST /v1/vm/service HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"serviceName":serviceName,
"paymentMethod": paymentMethod,
"needPublicIp": needPublicIp,
"bandwidth":bandwidth,
"deployInstances": {
"region":region,
"serviceProvider":serviceProvider,
"city":city,
"replicas":replicas
},
"cpu":cpu,
"memory":memory,
"imageId":imageId,
"rootDiskSizeInGb":rootDiskSizeInGb,
"adminPass":adminPass,
"dataVolumeList":{
"name":name,
"volumeType":volumeType,
"sizeInGB":sizeInGB
},
"disableIntranet": disableIntranet,
"disableCloudInit": disableCloudInit
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| serviceName | String | 是 | RequestBody参数 | 虚机服务名称 |
| paymentMethod | String | 否 | RequestBody参数 | 付费方式,缺省为postpay |
| needPublicIp | boolean | 否 | RequestBody参数 | 是否开通公网,缺省为false |
| bandwidth | int | 否 | RequestBody参数 | 公网带宽大小 |
| deployInstances | List |
是 | RequestBody参数 | 部署区域 |
| cpu | int | 是 | RequestBody参数 | cpu大小,必须大于1 |
| memory | int | 是 | RequestBody参数 | memory大小,必须大于1 |
| imageId | String | 是 | RequestBody参数 | 镜像id |
| rootDiskSizeInGb | int | 否 | RequestBody参数 | 系统盘大小,必须大于40,缺省为40 |
| dataVolumeList | List |
否 | RequestBody参数 | 数据盘 |
| adminPass | String | 是 | RequestBody参数 | 密码 |
| disableIntranet | boolean | 否 | RequestBody参数 | 是否需要内网,缺省为false |
| disableCloudInit | boolean | 否 | RequestBody参数 | 是否需要网络初始化,缺省为false |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | boolean | 返回结果，true为成功 |
| action | String | 操作描述 |
| details | Map | 返回结果，仅包含serviceId，类型为String |
错误码
请参照前文的统一错误码和平台错误码。
请求示例
POST /v1/vm/service HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"dataVolumeList":[
],
"adminPass":"root12345",
"imageId":"m-awDKZUma",
"bandwidth":100,
"rootDiskSizeInGb":45,
"deployInstances":[
{
"region":"SOUTH_WEST",
"city":"CHENGDU",
"serviceProvider":"CHINA_UNICOM",
"replicas":1
}],
"serviceName":"test",
"purchaseMonth":null,
"needPublicIp":false,
"cpu":4,
"memory":8,
"paymentMethod":"postpay",
"disableIntranet": false,
"disableCloudInit": false
}响应示例
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":true,
"action":"create",
"details":{
"serviceId":"s-8hzqkjng"
}
}Model对象定义
ActionInfoVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | boolean | 返回结果，true为成功 |
| action | String | 操作描述 |
| details | Map | 返回结果，仅包含serviceId，类型为String |
VolumeConfig
| 参数名称 | 类型 | 描述 |
|---|---|---|
| name | String | 磁盘名称 |
| sizeInGB | int | 磁盘大小(单位G) |
| volumeType | DiskType | 磁盘类型(NVME,SATA) |
DeploymentInstance
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | Region | 区域 |
| serviceProvider | ServiceProvider | 运营商 |
| city | String | 城市 |
| replicas | int | 副本数,最小为1 |