批量创建按量付费或者包年包月云主机

POST

/v4/ecs/batch-new

支持批量创建按量付费或包年包月云主机
注意：
1.系统盘参数syshd大小必须大于等于镜像的大小。
2.子网类型不能为裸机属子网。

请求参数

Header 参数

Body 参数application/json

示例

{
    "clientToken": "/batch-new-2111231111111111111",
    "regionID": "nm8",
    "azName": "az1",
    "vmName": "test-ht04040034",
    "displayName": "test-0021",
    "flavorID": "cc2a3bdb-0572-acf6-f0f5-0fdf9eccc286",
    "imageID": "693833be-050c-4509-b968-de08bba42a85",
    "syshdType": "SATA",
    "syshd": 40,
    "vpc": "09344bd1-1b7e-45af-9b95-48959c61c0d9",
    "onDemand": false,
    "diskList": [
        {
            "title": "disk-dongmg",
            "diskType": "system",
            "type": "SATA",
            "size": 100
        }
    ],
    "secGroupList": [],
    "rootPassword": "M4ssQrm0*",
    "networkCardList": [
        {
            "fixedIP":"",
            "title": "",
            "master": true,
            "subnetID": "8d3a5ede-4f4e-46d2-a4a8-55f762a5ca61"
        }
    ],
    "extIP": "0",
    "cycleCount": 10,
    "cycleType": "MONTH",
    "orderCount":3,
    "userData": "ZWNobyBoZWxsbyBnb3N0YWNrIQ=="
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/ecs/batch-new' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientToken": "/batch-new-2111231111111111111",
    "regionID": "nm8",
    "azName": "az1",
    "vmName": "test-ht04040034",
    "displayName": "test-0021",
    "flavorID": "cc2a3bdb-0572-acf6-f0f5-0fdf9eccc286",
    "imageID": "693833be-050c-4509-b968-de08bba42a85",
    "syshdType": "SATA",
    "syshd": 40,
    "vpc": "09344bd1-1b7e-45af-9b95-48959c61c0d9",
    "onDemand": false,
    "diskList": [
        {
            "title": "disk-dongmg",
            "diskType": "system",
            "type": "SATA",
            "size": 100
        }
    ],
    "secGroupList": [],
    "rootPassword": "M4ssQrm0*",
    "networkCardList": [
        {
            "fixedIP":"",
            "title": "",
            "master": true,
            "subnetID": "8d3a5ede-4f4e-46d2-a4a8-55f762a5ca61"
        }
    ],
    "extIP": "0",
    "cycleCount": 10,
    "cycleType": "MONTH",
    "orderCount":3,
    "userData": "ZWNobyBoZWxsbyBnb3N0YWNrIQ=="
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "clientToken": "20240529",
    "regionID": "nm8",
    "azName": "az1",
    "vmName": "test-ht04040034",
    "displayName": "test-21",
    "flavorID": "cc2a3bdb-0572-acf6-f0f5-0fdf9eccc286",
    "imageID": "693833be-050c-4509-b968-de08bba42a85",
    "syshdType": "SATA",
    "syshd": 40,
    "vpc": "09344bd1-1b7e-45af-9b95-48959c61c0d9",
    "onDemand": false,
    "diskList": [
        {
            "title": "disk-dongmg",
            "diskType": "system",
            "type": "SATA",
            "size": 100
        }
    ],
    "secGroupList": [],
    "rootPassword": "M4ssQrm0*",
    "networkCardList": [
        {
            "fixedIP": "",
            "title": "",
            "master": true,
            "subnetID": "8d3a5ede-4f4e-46d2-a4a8-55f762a5ca61"
        }
    ],
    "extIP": "0",
    "cycleCount": 1,
    "cycleType": "MONTH",
    "orderCount": 3,
    "userData": "ZWNobyBoZWxsbyBnb3N0YWNrIQ=="
}

修改于 2026-03-19 02:17:32

创建一台按量付费或包年包月的云主机（新版）

退订或销毁云主机