批量创建轻量虚拟机（工单）

请求参数

Body 参数application/json

object | null

可选

channelInfo

object | null

渠道侧信息

可选

渠道侧信息

paasAccoutID

string

paas账号

必需

paas账号，资源的付费账号，通过上送IT用于内部结算

masterOrderID

string

中台主订单ID

必需

中台主订单ID，IaaS记⼊话单，用来关联订单和资源

paasResourceID

string

资源ID

必需

IT侧订单对应资源ID

clientToken

string

必需

客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一

regionID

string

资源池ID

必需

资源池ID

azName

string

可用区名称

必需

可用区名称

instanceName

string

云主机名称

必需

Windows：长度为2~15个字符，允许使用大小写字母、数字或连字符（-）。不能以连字符（-）开头或结尾，不能连续使用连字符（-），也不能仅使用数字；
其他操作系统：长度为2-64字符，允许使用点（.）分隔字符成多段，每段允许使用大小写字母、数字或连字符（-），但不能连续使用点号（.）或连字符（-），不能以点号（.）或连字符（-）开头或结尾

displayName

string

云主机显示名称

必需

云主机显示名称，长度为2-63字符

flavorID

string

云主机规格ID

必需

imageType

integer

镜像类型

必需

暂时不支持，取值范围:
0：私有镜像，
1：公有镜像，
2：共享镜像，
3：安全镜像，
4：甄选镜像

imageID

string

镜像ID

必需

vpcID

string

虚拟私有云ID

必需

zone

string

paas资源创建所在available

可选

暂不支持，该参数在生成环境中作废

networkCardList

array [object {5}]

网卡

必需

subnetID

string

子网ID

必需

非共享网卡时该参数为vpcID对应VPC下的子网ID，共享网卡时该参数为shareVpcID对应VPC下的子网ID

isMaster

boolean

是否主网卡

必需

true：表示主网卡，false：表示扩展网卡

nicName

string

网卡名称

可选

fixedIP

string

内网IPv4地址

可选

多台不能指定ip

shareVpcID

string

共享网卡的虚拟私有云ID

可选

extIP

string

是否使用弹性公网

必需

是否使用弹性公网IP，取值范围:
0：不使用，
1：自动分配，
2：使用已有

bootDiskType

string

系统盘类型

可选

取值范围:
SATA：普通IO，
SAS：高IO，
SSD：超高IO，
SSD-genric：通用型SSD，
FAST-SSD：极速型SSD,由于历史原因，目前仅按照前缀进行匹配

bootDiskSize

integer

系统盘大小

可选

在不指定系统盘ID创建时，该参数必填；指定系统盘ID创建时，该参数不可填。单位为GiB，取值范围：[40-32768]

sysVolumeID

string

系统盘ID

可选

填写该参数，bootDiskType、bootDiskSize不可填，不填写该参数，bootDiskType、bootDiskSize都必填

projectID

string

企业项目ID

可选

secGroupList

array[string]

安全组id列表

可选

dataDiskList

array [object {3}]

数据盘信息

可选

填写dataDiskIDList时，该参数无效

diskSize

integer

磁盘容量

必需

单位为GiB，取值范围：[10-32768]

diskType

string

磁盘类型

必需

取值范围:SATA：普通IO，SAS：高IO，SSD：超高IO，SSD-genric：通用型SSD，FAST-SSD：极速型SSD；由于历史原因，目前仅按照前缀进行匹配

diskName

string

磁盘名称

可选

长度2~63，不支持中文

dataDiskIDList

array[string]

数据盘ID

可选

数据盘ID列表

ipVersion

string

弹性IP版本

可选

取值范围:
ipv4：v4地址，
ipv6：v6地址

bandwidth

integer

带宽大小

可选

带宽大小单位为Mbit/s，取值范围:[1~2000]

eipID

string

弹性公网IP的

可选

弹性公网IP的ID（orderCount>1时不可用）

affinityGroupID

string

云主机组ID

可选

keyPairID

string

密钥对ID

可选

userPassword

string

用户密码

可选

满足以下规则：
长度在8～30个字符;
必须包含大写字母、小写字母、数字以及特殊符号中的三项;
特殊符号可选：()`~!@#$%^&*_-+=｜{}[]:;'<>,.?/\且不能以斜线号 / 开头

userData

string

用户自定义数据

可选

需要以Base64方式编码,Base64编码后的长度限制为1-16384字符

orderCount

integer

创建数量

可选

不指定默认为1，最大数量为50台。

示例

{
    "azName": "az1",
    "regionID": "TestRegionID",
    "instanceName": "demo-test1113",
    "ctUserId": 1000000723,
    "bandWidth": 40,
    "displayName": "demo-test1113",
    "flavorID": "7db53259-9047-ac39-dd37-367a45c49b2a",
    "imageType": 0,
    "imageID": "e70588fe-22a8-4bb5-a70b-62133aa8b90f",
    "bootDiskType": "SAS",
    "bootDiskSize": 40,
    "vpcID": "vpc-q63pkp6zuw",
    "extIP": "1",
    "secGroupList": [
        "sg-svrirhal6p"
    ],
    "userPassword": "M4ssQrm0*",
    "networkCardList": [
        {
            "nicName": "",
            "isMaster": true,
            "subnetID": "subnet-714nkryvjv"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/paas/ecs/batch-create-lite-vm' \
--header 'Content-Type: application/json' \
--data-raw '{
    "azName": "az1",
    "regionID": "TestRegionID",
    "instanceName": "demo-test1113",
    "ctUserId": 1000000723,
    "bandWidth": 40,
    "displayName": "demo-test1113",
    "flavorID": "7db53259-9047-ac39-dd37-367a45c49b2a",
    "imageType": 0,
    "imageID": "e70588fe-22a8-4bb5-a70b-62133aa8b90f",
    "bootDiskType": "SAS",
    "bootDiskSize": 40,
    "vpcID": "vpc-q63pkp6zuw",
    "extIP": "1",
    "secGroupList": [
        "sg-svrirhal6p"
    ],
    "userPassword": "M4ssQrm0*",
    "networkCardList": [
        {
            "nicName": "",
            "isMaster": true,
            "subnetID": "subnet-714nkryvjv"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

statusCode

integer

状态码

必需

800为成功，900为失败

errorCode

string

业务细分码

必需

message

string

失败时的错误描述

必需

失败时的错误描述，一般为英文描述

description

string

必需

失败时的错误描述，一般为中文描述

returnObj

object

成功时返回的数据

必需

jobID

string

任务ID

必需

查看创建云主机的任务状态请使用该参数调用查询任务接口进行查看

示例

{
    "statusCode": 800,
    "errorCode": "SUCCESS",
    "message": null,
    "description": "SUCCESS",
    "returnObj": {
        "jobID": "20231113000001"
    }
}