创建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 |