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

POST

/v4/ecs/create-instance

目前不支持预付费账户创建按需付费类型云主机

计费模式选择包年包月计费方式时，需要填写订购周期类型与订购时长

自动分配弹性IP（extIP="1"）时，需要填写弹性IP版本（ipVersion）与带宽大小（bandwidth）；使用已有的弹性IP（extIP="2"）时，需要填写弹性IP的版本（ipVersion），和对应弹性IP的ID（eipID或ipv6AddressID）

挂载网卡时，子网与虚拟私有云存在对应关系，确保子网属于当前虚拟私有云

云主机绑定多个标签时，标签键（参数labelKey）不可重复，单台云主机最多可绑定10个标签

因对接方原因，instanceName允许重复

请求参数

Header 参数

Body 参数application/json

示例

{
    "clientToken": "sfdser3jyukiuoipp123457812344455",
    "azName":"cn-xinan1-1A",
    "onDemand":true,
    "regionID":"2022guizhou_syj",
    "instanceName":"dongmg1120",
    "displayName":"指定系统盘开通测试az1-1124",
    "flavorID" : "05fd7dcf-616d-1425-8281-e88ea406fc5d",
    "imageID":"0666aef1-f439-4817-ba7c-40fe490fa761",
    "bootDiskType":"SATA-public",
    "bootDiskSize":40,
    //"sysVolumeID":"1284b57c-c8ad-41b8-8f65-ae1b96482f95",
    "vpcID":"f3c4430c-a688-41df-8575-6fb983070bcc",
    "secGroupList":[
        "aca541e1-f50f-44f9-82b4-1b30754589bc"
    ],
    "extIP": "0",
    "rootPassword":"Ecs@2025",
    "networkCardList":[
        {
            "isMaster": true,
            "subnetID":"784d5b50-dc36-4308-b755-af93350fad5c",
            "fixedIP": ""
        },
        {
            "isMaster": false,
            "subnetID":"376b0680-1cdb-43b9-9fa2-c6fc3e4d50c3",
            "fixedIP": ""
        }
    ],
   //"cycleCount": 3,
   //"cycleType": "MONTH",
   "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/create-instance' \
--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": "sfdser3jyukiuoipp123457812344455",
    "azName":"cn-xinan1-1A",
    "onDemand":true,
    "regionID":"2022guizhou_syj",
    "instanceName":"dongmg1120",
    "displayName":"指定系统盘开通测试az1-1124",
    "flavorID" : "05fd7dcf-616d-1425-8281-e88ea406fc5d",
    "imageID":"0666aef1-f439-4817-ba7c-40fe490fa761",
    "bootDiskType":"SATA-public",
    "bootDiskSize":40,
    //"sysVolumeID":"1284b57c-c8ad-41b8-8f65-ae1b96482f95",
    "vpcID":"f3c4430c-a688-41df-8575-6fb983070bcc",
    "secGroupList":[
        "aca541e1-f50f-44f9-82b4-1b30754589bc"
    ],
    "extIP": "0",
    "rootPassword":"Ecs@2025",
    "networkCardList":[
        {
            "isMaster": true,
            "subnetID":"784d5b50-dc36-4308-b755-af93350fad5c",
            "fixedIP": ""
        },
        {
            "isMaster": false,
            "subnetID":"376b0680-1cdb-43b9-9fa2-c6fc3e4d50c3",
            "fixedIP": ""
        }
    ],
   //"cycleCount": 3,
   //"cycleType": "MONTH",
   "userData": "ZWNobyBoZWxsbyBnb3N0YWNrIQ=="
}'

返回响应

🟢200successful operation

application/json

Body

示例

成功示例成功示例

{
    "statusCode": 800,
    "errorCode": "SUCCESS",
    "message": "success",
    "description": "SUCCESS",
    "returnObj": {
        "masterOrderID": "195ea0cd-8148-df32-9e49-59a9119ba76a",
        "masterOrderNO": "20230404071376",
        "masterResourceID": "8c01d491-cdd1-6bec-eda3-a7fdf7ccde09",
        "regionID": "nm8",
        "resources": [
            {
                "resourceID": "a653095c5cbb4c7a95f366b07e873235"
            }
        ]
    }
}

修改于 2026-04-01 06:05:21

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

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