接口功能介绍

支持批量创建按量付费或包年包月云主机
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
  计费模式：确认开通云主机的计费模式，详细查看计费模式
  地域选择：选择创建云主机的资源池，详细查看地域和可用区
  产品选型：购买弹性云主机前，请先阅读规格说明了解弹性云主机的选型基本信息，并通过查询一个或多个云主机规格资源接口，获取当前资源池可用云主机规格信息
  网络规划：规划云主机的网络环境，详细查看弹性云主机-网络
注意事项：
  成本估算：了解云主机的计费项
  用户配额：确认个人在不同资源池下资源配额，可以通过用户配额查询接口进行查询
  异步接口：该接口为异步接口，下单过后会拿到主订单ID（masterOrderID），后续可以调用根据masterOrderID查询云主机ID，使用主订单ID来对订单情况与开通成功后的资源ID进行查询
  多台创建：当前接口只能创建多个同类型云主机，个性化创建不同类型云主机请使用接口创建一台按量付费或包年包月的云主机进行创建
  企业项目：保证资源隔离，需确保所有资源与云主机处于相同企业项目下才可进行挂载操作，如网络资源：VPC、安全组、弹性IP、子网
  标签绑定：云主机绑定标签时，标签键和值存在的情况下，绑定对应标签；不存在的情况下，创建新的标签并绑定云主机。主机创建完成后，云主机变为运行状态，此时标签仍可能未绑定，需等待一段时间（0-10分钟）
  监控安装：在云服务器创建成功后，3-5分钟内将完成详细监控Agent安装，即开启云服务器CPU，内存，网络，磁盘，进程等指标详细监控，若不开启，则无任何监控数据。
  代金券：只支持预付费用户抵扣包周期资源的金额，且不可超过包周期资源的金额

接口约束

  1. 目前不支持预付费账户创建按需付费类型云主机
  2. 计费模式选择包年包月计费方式时，需要填写订购周期类型与订购时长
  3. 自动分配弹性IP（extIP="1"）时，需要填写弹性IP版本（ipVersion）与带宽大小（bandwidth）；使用已有的弹性IP（extIP="2"）时，需要填写弹性IP的版本（ipVersion），和对应弹性IP的ID（eipID或ipv6AddressID）
  4. 挂载网卡时，子网与虚拟私有云存在对应关系，确保子网属于当前虚拟私有云
  5. 云主机绑定多个标签时，标签键（参数labelKey）不可重复，单台云主机最多可绑定10个标签

URI

POST /v4/ecs/batch-create-instances

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

表 dataDiskList

表 networkCardList

表 labelList

响应参数

表 returnObj

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例1：多可用区类型资源池，创建按量付费的普通云主机（不使用密钥对、云主机组、弹性公网、自定义数据等内容，不挂数据盘、副网卡）
在华东1可用区1创建5台按需付费的云主机，系统盘为普通IO类型、大小40GB，规格为s7.small.1，镜像为共有镜像CentOS8.0 64位。
{
    "clientToken": "please_create_your_own_clientToken_not_use_create_example_01",  
    "regionID": "bb9fdb42056f11eda1610242ac110002", 
    "azName": "cn-huadong1-jsnj1A-public-ctcloud",
    "instanceName": "create-test01",
    "displayName": "api-create01",
    "flavorID": "34e1b6f6-e974-1575-20b2-172ba0e0bf83",
    "imageType": 1,
    "imageID": "d39aba04-2470-4eea-acdc-10cb4f962588",
    "bootDiskType": "SATA",
    "bootDiskSize": 40,
    "extIP": "0",
    "onDemand": true,
    "orderCount": 5,
    "vpcID": "vpc-chz0ilszsp",
    "networkCardList": [
        {
            "subnetID": "subnet-4c4333pc67",
            "isMaster": true
        }
    ]
}

示例2：非多可用区类型资源池，创建包年包月付费的普通云主机（不使用密钥对、云主机组、弹性公网、自定义数据等内容，不挂数据盘、副网卡）
在内蒙6创建1台包周期付费的云主机，购买六个月，系统盘为高IO类型、大小50GB，规格为s6.medium.2，镜像为共有镜像ubuntu16.04。
主网卡指定内网IP，使用已有弹性公网。
{
    "clientToken": "please_create_your_own_clientToken_here_not_use_create_example_02",  
    "regionID": "6019b5007a0b11eab5db0242ac110002", 
    "azName": "default",
    "instanceName": "create-test02",
    "displayName": "api-create02",
    "flavorID": "d7ac25ac-5dd9-4e8e-bb4e-3e9a861ad829",
    "imageType": 1,
    "imageID": "9f59941d-ae69-45e5-a6ee-1b6ec8da2bae",
    "bootDiskType": "SATA",
    "bootDiskSize": 50,
    "extIP": "2",
    "ipVersion": "ipv4",
    "eipID": "8293c309-63aa-4e3a-8f9f-e7038f660c9c",
    "onDemand": false,
    "cycleType": "MONTH",
    "cycleCount": 6,
    "orderCount": 1,
    "vpcID": "8d9698a5-f9e4-405b-a5a2-3468c25ddda1",
    "networkCardList": [
        {
            "subnetID": "1932614b-e33a-466c-beb1-c399a86fa6b0",
            "isMaster": true,
            "fixedIP": "192.168.0.17"
        }
    ]
}

示例3：多可用区类型资源池，创建按需付费的云主机，并绑定密钥对、加入云主机组，使用弹性公网、自定义数据，挂载数据盘与副网卡
在华东1可用区2创建4台按需付费的云主机，系统盘为高IO类型、大小100GB，规格为计算增强型c7.2xlarge.2，镜像为共有镜像Ubuntu 18.04 64位。
增加副网卡，增加一块20GB大小的数据盘，类型为普通IO；绑定密钥对，加入云主机组、自动分配公网IP，带宽为2，使用自定义数据，指定项目ID。
该次订购使用代金券支付，后续自动续订，绑定一组标签。
{
    "clientToken": "please_create_your_own_clientToken_here_not_use_create_example_03",  
    "regionID": "bb9fdb42056f11eda1610242ac110002", 
    "azName": "cn-huadong1-jsnj2A-public-ctcloud",
    "instanceName": "create-test03",
    "displayName": "api-create03",
    "flavorID": "4c7da688-88fc-412d-d20e-f647dd4a8310",
    "imageType": 1,
    "imageID": "26ec204c-ebe5-47b9-bff9-32da77026228",
    "bootDiskType": "SAS",
    "bootDiskSize": 100,
    "extIP": "1",
    "ipVersion": "ipv4",
    "bandwidth": 2,
    "onDemand": true,
    "orderCount": 3,
    "vpcID": "vpc-chz0ilszsp",
    "networkCardList": [
        {
            "subnetID": "subnet-4c4333pc67",
            "isMaster": true
        },
        {
            "subnetID": "subnet-3lrbkaj66a",
            "isMaster": false
        }
    ],
    "dataDiskList": [
        {
            "diskMode": "VBD",
            "diskType": "SATA",
            "diskSize": 20
        }
    ],
    "keyPairID": "48edb5e9-c66a-3f74-907d-a45e771a8cef",
    "affinityGroupID": "924b95c4-68d9-3fbe-835d-fee46397feda",
    "projectID": "95e17b31e41e4d509687398baf91c260",
    "autoRenewStatus": 1,
    "userData": "b3BlbmFwaV91c2VyRGF0YV90ZXN0",
    "payVoucherPrice": "450.00",
    "labelList": [{
        "labelKey": "test-label",
        "labelValue": "test-value"
	}]
}

响应示例

{
    "returnObj": {
        "regionID": "81f7728662dd11ec810800155d307d5b",
        "masterOrderID": "107e901c449611ed8b6a0242ac110002",
        "masterResourceID": "34c7cc05a52b48eda0a84e34a82b346b",
        "masterOrderNO": "20221009163836430197"
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码