接口功能介绍

本接口提供用户在专属云中批量创建按量付费的云主机的功能
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
  计费模式：确认开通云主机的计费模式，详细查看计费模式
  地域选择：选择要创建云主机的专属云的资源池
  产品选型：购买弹性云主机前，请先阅读规格说明了解弹性云主机的选型基本信息，并通过查询一个或多个云主机规格资源接口，获取当前资源池可用云主机规格信息
  网络规划：规划云主机的网络环境，详细查看弹性云主机-网络
注意事项：
  成本估算：了解云主机的计费项
  用户配额：确认个人在不同资源池下资源配额，可以通过用户配额查询接口进行查询
  异步接口：该接口为异步接口，下单过后会拿到主订单ID（masterOrderID），后续可以调用根据masterOrderID查询云主机ID，使用主订单ID来对订单情况与开通成功后的资源ID进行查询
  单台创建：当前接口只能创建单台云主机
  监控安装：在云服务器创建成功后，3-5分钟内将完成详细监控Agent安装，即开启云服务器CPU，内存，网络，磁盘，进程等指标详细监控，若不开启，则无任何监控数据。

接口约束

  1. 专属云内创建云主机均为按需类型云主机
  2. 自动分配弹性IP（extIP="1"）时，需要填写弹性IP版本（ipVersion）与带宽大小（bandwidth）；使用已有的弹性IP（extIP="2"）时，需要填写弹性IP的版本（ipVersion）和对应弹性IP的ID（eipID或ipv6AddressID）
  3. 挂载网卡时，子网与虚拟私有云存在对应关系，确保子网属于当前虚拟私有云

URI

POST /v4/dec/batch-create-instance

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

表 dataDiskList

表 networkCards

响应参数

表 returnObj

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例1：创建2台云主机，配置各项内容，自动分配弹性公网IP，设置带宽为2Mbit/s。
在专属云内，系统盘选超高IO类型、大小40GB，并增加40GB高IO类型数据盘。
规格为s7.small.1，镜像为CTyunOS-3_23.01-x86_64_20240926。
主网卡指定内网IP地址，并配置使用指定安全组，加入指定云主机组，设置密码。
{
    "regionID": "7fbbfa0a349241cbb476c492ef1cea20",
    "azName": "az1",
    "instanceName": "test1605",
    "displayName": "test11605",
    "flavorID": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
    "imageType": 1,
    "imageID": "0a50ee7b-a91a-4b8f-afe5-1508ce53578c",
    "vpcID": "vpc-umcq94wcc2",
    "bootDiskType": "SSD",
    "bootDiskSize": 40,
    "extIP": "1",
    "onDemand": true,
    "userPassword":"HelloCtyun.13",
    "projectID":"0",
    "secGroupList":["sg-cpel83ehwl"],
    "networkCardList": [
        {
            "subnetID": "subnet-con3h8n36g",
            "isMaster": true,
            "fixedIP":"10.0.0.123"
        }
    ],
    "dataDiskList": [
        {
            "diskType":"SAS",
            "diskSize":40,
            "diskMode":"VBD",
            "diskName":"test-data-yul-test1605"
        }
    ],
    "ipVersion":"ipv4",
    "bandwidth":2,
    "affinityGroupID":"e89c5ce9-8e72-4a9b-b963-2fe7c5f6254a",
	"userPassword": "Test1556",
    "monitorService": false,
    "orderCount":2,
    "clientToken": "9fc6fa0de-ebe7-4168-9ea2-802sdware18101644"
}
示例2：
创建2台云主机，配置各项内容，不使用弹性公网IP。
系统盘指定专属存储池选择超高IO类型、大小40GB，并增加一块指定专属存储池选择高IO类型、大小40G的数据盘。
规格为s7.small.1，镜像为CTyunOS-3_23.01-x86_64_20240926
{
    "regionID": "7fbbfa0a349241cbb476c492ef1cea20",
    "azName": "az1",
    "instanceName": "test1051",
    "displayName": "test1051",
    "flavorID": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
    "imageType": 1,
    "imageID": "0a50ee7b-a91a-4b8f-afe5-1508ce53578c",
    "vpcID": "vpc-umcq94wcc2",
    "bootDiskType": "SSD",
    "bootDiskSize": 40,
    "extIP": "0",
    "onDemand": true,
    "userPassword":"HelloCtyun.13",
    "affinityGroupID":"",
    "projectID":"0",
    "secGroupList":null,
    "networkCardList": [
        {
            "subnetID": "subnet-con3h8n36g",
            "isMaster": true
        }
    ],
    "dataDiskList": [
        {
            "diskType":"SAS",
            "diskSize":40,
            "decTypeID":"26f82b6f-59f1-4cda-b608-0cd366a2eb9e"
        }
    ],
    "ipVersion":"ipv4",
    "bandwidth":2,
    "monitorService": false,
    "decTypeID":"9d8aa7d3-4fef-40dc-b2e2-6692b5ae8e34",
    "orderCount":2,
    "clientToken": "9fc6fa0de-ebe7-4168-9ea2-802sdware18101104"
}

响应示例

{
	"returnObj": {
		"masterResourceID": "39559b25eabf455481aa9e3882d3b0a7",
		"masterOrderNO": "20221202173339078653",
		"regionID": "ef901a5734964ce29eedac918c4716a3",
		"masterOrderID": "0ea2d572722311eda5fb0242ac110002"
	},
	"message": "SUCCESS",
	"description": "成功",
	"statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码