创建BEC无实例的虚机服务
更新时间：2021-08-03
接口描述
本接口用于创建BEC无实例的虚机服务，相当于获取一个空实例组的serviceId。然后可以用创建BEC虚机实例的接口向该serviceId服务添加实例。
请求结构
POST /v1/vm/service HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"serviceName": serviceName,
"paymentMethod": paymentMethod
}
请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| serviceName | String | 否 | RequestBody参数 | 虚机服务名称（不传为随机名称） |
| paymentMethod | String | 否 | RequestBody参数 | 付费方式，目前只支持postpay（不传缺省为postpay) |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | Boolean | 返回结果，true：表示成功，false：表示失败 |
| action | String | 系统返回的操作描述，返回值“create” |
| 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
{
"serviceName": "test",
"paymentMethod": "postpay"
}响应示例
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-zz9r0enj",
"serviceName": "test",
"status": "NORMAL",
"totalCpu": 0,
"totalMem": 0,
"totalDisk": 0,
"totalRootDisk": 0,
"regions": 0,
"totalInstances": 0,
"runningInstances": 0,
"totalGpu": 0,
"dataVolumeList": [],
"systemVolumeList": []
}
}Model对象定义
ActionInfoVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | boolean | 返回结果，true为成功，false为不成功 |
| action | String | 系统返回的操作描述，本接口的值是create |
| details | Map | 返回结果，包含VmServiceBriefVo |
VmServiceBriefVo
创建无实例的服务，返回主要serviceId, 其他的VM统计相关参数的值为零或者空。
| 参数名称 | 类型 | 描述 |
|---|---|---|
| serviceId | String | 虚机服务ID |
| serviceName | String | 虚机服务名称 |
| status | String | 资源状态(初始为NORMAL，其他状态参考创建BEC虚机实例的接口的该字段定义) |
| totalCpu | float | CPU数量，初始为0 |
| totalMem | float | 内存数量，初始为0 |
| totalRootDisk | Integer | 系统盘数量，初始为0 |
| totalDisk | Integer | 数据盘数量，初始为0 |
| regions | Integer | 区域数量，初始为0 |
| totalInstances | Integer | 总实例数，初始为0 |
| runningInstances | Integer | 运行实例数，初始为0 |