创建BEC虚机实例
更新时间:2024-12-25
接口描述
本接口用于创建BEC虚机实例。
请求结构
Plain Text
1POST /v2/vm/instance?clientToken={clientToken} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
4X-Bce-Accesskey: accesskey
5
6{
7 "adminPass": "",
8 "autoRenewTime": 0,
9 "autoRenewTimeUnit": "month、year",
10 "billing": {
11 "paymentTiming": "Postpaid、Prepaid",
12 "reservation": {
13 "reservationLength": 0,
14 "reservationTimeUnit": "month、year"
15 }
16 },
17 "cardCount": 0,
18 "cpuCount": 0,
19 "createCdsList": [
20 {
21 "cdsSizeInGB": 0,
22 "name": "",
23 "storageType": "CDS_SSD"
24 }
25 ],
26 "deployInstances": [
27 {
28 "purchaseCount": 0,
29 "regionId": "",
30 "subnetId": "",
31 "vpcId": ""
32 }
33 ],
34 "ephemeralDisks": [
35 {
36 "name": "",
37 "sizeInGB": 0,
38 "storageType": "NVME、SATA"
39 }
40 ],
41 "gpuCard": "",
42 "hostname": "",
43 "imageId": "",
44 "imageType": "bec、bcc",
45 "keypairId": "",
46 "memoryCapacityInGB": 0,
47 "name": "",
48 "networkCapacityInMbps": 0,
49 "passthroughDisks": [
50 {
51 "name": "",
52 "passthroughCode": "",
53 "storageType": "HDD_PASSTHROUGH、SSD_PASSTHROUGH"
54 }
55 ],
56 "rootDiskName": "",
57 "rootDiskSizeInGb": 0,
58 "rootDiskStorageType": "",
59 "securityGroupId": "",
60 "serviceId": "",
61 "spec": "",
62 "needPublicSpeedIp": false,
63 "userData": "userData",
64 "tags": [
65 {
66 "tagKey": "tagKey",
67 "tagValue": "tagValue"
68 }
69 ]
70}
请求头域
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
---|---|---|---|---|
X-Bce-Accesskey | BEC加密接口返回的accessKeyId,用作虚机实例管理员密码解密。参考密码加密传输规范 | header | 否 | string |
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
---|---|---|---|---|
request | 创建虚机实例请求 | body | 是 | CreateBecVmInstanceRequest |
adminPass | 虚机密码限制长度为8~32位字符,英文、数字和符号必须同时存在, 符号仅限!@#$%^+*() keypairId和adminPass不能同时为空 |
否 | string | |
autoRenewTime | 自动续费的时间 | 否 | integer | |
autoRenewTimeUnit | 自动续费按月付费或者按年付费。月是month,年是year | 否 | string | |
billing | 订单、计费相关参数 | 是 | Billing | |
paymentTiming | 付费方式 | 是 | string | |
reservation | 时长信息 | 否 | Reservation | |
reservationLength | 时长 | 否 | integer | |
reservationTimeUnit | 时间单位 | 否 | string | |
cardCount | 待创建实例所要携带的GPU卡数量 | 否 | integer | |
cpuCount | 待创建虚拟机实例的CPU核数 | 否 | integer | |
createCdsList | 数据盘云磁盘 | 否 | List<CreateCdsModel> | |
cdsSizeInGB | 云磁盘容量 | 否 | integer | |
name | 云磁盘名称 | 否 | string | |
storageType | 云磁盘类型 | 否 | string | |
deployInstances | 部署区域 | 是 | List<DeployInstance> | |
networkType | 指定网络类型,枚举值有classic(经典网络)或vpc(VPC网络)。 | 否 | string | |
purchaseCount | 购买数量 | 是 | integer | |
regionId | 节点ID。由“国家码-城市-运营商”的小写字母组成字符串。例如 cn-hangzhou-cm, 其中国家码标准为ISO 3166-2,城市为拼音,运营商为中国移动cm/中国电信ct/中国联通un/三线ix, 海外节点运营商为bgp。通过/v2/node/type/vm 接口查询获取。 |
是 | string | |
subnetId | 子网ID | 否 | string | |
vpcId | VPC ID | 否 | string | |
deployIdList | 部署集ID列表,目前只支持数量为1。 | 否 | List<String> | |
ephemeralDisks | 数据盘本地盘 | 否 | List<EphemeralDisk> | |
name | 本地盘名称 | 否 | string | |
sizeInGB | 本地盘大小 | 否 | integer | |
storageType | 本地盘类型 | 否 | string | |
gpuCard | 待创建实例所要携带的GPU卡信息 | 否 | string | |
hostname | 虚机hostname(不传为随机名称)。仅支持小写字母、数字以及-特殊字符, 必须以字母开头,长度2-64。 |
否 | string | |
imageId | 镜像ID(配合imageType使用) | 是 | string | |
imageType | 镜像类型,bec: 公共镜像或bec自定义镜像; bcc: bcc自定义镜像。默认bec | 否 | string | |
keypairId | 待创建实例所要绑定的密钥对ID。keypairId和adminPass不能同时为空 | 否 | string | |
memoryCapacityInGB | 待创建虚拟机实例的内存容量,单位GB | 否 | integer | |
name | 虚机实例名称(不传为随机名称) | 否 | string | |
networkCapacityInMbps | 公网带宽,单位为Mbps。为0表示不分配公网IP,默认为0Mbps。 | 否 | integer | |
passthroughDisks | 数据盘独占盘 | 否 | List<PassthroughDiskModel> | |
name | 独占盘名称 | 否 | string | |
passthroughCode | 独占盘编码 | 是 | string | |
storageType | 独占盘类型 | 否 | string | |
rootDiskName | 系统盘名称,默认是sys | 否 | string | |
rootDiskSizeInGb | 待创建虚拟机实例的系统盘大小,单位GB,默认是40GB | 否 | integer | |
rootDiskStorageType | 待创建虚拟机实例系统盘类型,默认NVME。支持NVME、SATA、CDS_SSD、CDS_HDD | 否 | string | |
securityGroupId | 指定安全组,为空时将使用默认安全组 | 否 | string | |
serviceId | 服务ID,如果有指定,则添加实例到服务。如果为空,则创建一个服务 | 否 | string | |
spec | 分机型规格族,如果指定,则为分机型策略。如果为空,则为随机策略;使用spec参数则不需要填写cpuCount/memoryCapacityInGB | 否 | string | |
needPublicSpeedIp | 是否选择公网加速IP | 否 | boolean | |
userData | 自定义注入的数据,以如下的方式编码: base64(user_injected_data: base64(原文))。注意:user_injected_data冒号后+1个空格+base64字符串。 | 否 | string | |
tags | 标签信息 | 否 | List<TagModel> | |
tagKey | 标签键 | 否 | String | |
tagValue | 标签值 | 否 | String | |
clientToken | 幂等性Token,是一个长度不超过64位的ASCII字符串 | query | 否 | string |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
instances | 实例列表 | List<CreateBecVmInstanceModel> |
instanceId | 实例ID | string |
regionId | 节点ID | string |
orderIdList | 预付费 订单ID列表 | List<String> |
serviceId | 服务id | string |
错误码
请参照错误返回章节的内容。
请求示例
分机型策略
Plain Text
1POST /v2/vm/instance?clientToken=123456789 HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "name":"test",
7 "keypairId": "k-xxxxxxxx",
8 "spec":"bec.g4.c1m4",
9 "imageId": "m-kHYPoKjl",
10 "imageType": "bec",
11 "deployInstances": [
12 {
13 "regionId": "cn-hangzhou-cm",
14 "purchaseCount": 1
15 }
16 ],
17 "billing": {
18 "paymentTiming": "Postpaid"
19 }
20}
随机策略
Plain Text
1POST /v2/vm/instance?clientToken=123456789 HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "name":"test",
7 "keypairId": "k-xxxxxxxx",
8 "cpuCount": 1,
9 "memoryCapacityInGB": 4,
10 "imageId": "m-kHYPoKjl",
11 "imageType": "bec",
12 "deployInstances": [
13 {
14 "regionId": "cn-hangzhou-cm",
15 "purchaseCount": 1
16 }
17 ],
18 "billing": {
19 "paymentTiming": "Postpaid"
20 }
21}
自定义密码
Plain Text
1POST /v2/vm/instance?clientToken=123456789 HTTP/1.1
2Host: bec.baidubce.com
3X-Bce-Accesskey: accesskey
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "name":"test",
8 "adminPass": "fbf1eaa91fc03ed239854885c1a84cb5",
9 "spec":"bec.g4.c1m4",
10 "imageId": "m-kHYPoKjl",
11 "imageType": "bec",
12 "deployInstances": [
13 {
14 "regionId": "cn-hangzhou-cm",
15 "purchaseCount": 1
16 }
17 ],
18 "billing": {
19 "paymentTiming": "Postpaid"
20 }
21}
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6
7{
8 "serviceId": "s-njocgbmg",
9 "instances": [
10 {
11 "instanceId": "vm-njocgbmg-1-m-hangzhou-rvquh",
12 "regionId": "cn-hangzhou-cm"
13 }
14 ]
15}