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

POST

/v4/ecs/create

支持创建一台按量付费或包年包月的云主机
注意：
1.系统盘参数syshd大小必须大于等于镜像的大小。
2.子网类型不能为裸机属子网。
3. 因对接方原因，instanceName允许重复

请求参数

Header 参数

Body 参数application/json

示例

{
    "azName": "cn-gd-can3-2a-hybrid-industry",
    "onDemand": true,
    "regionID": "cn-gd-can3-hybrid-industry",
    "vmName": "test-0929001",
    "displayName": "test-0929001",
    "flavorID": "8c481a96-bfa0-0e68-4b9b-ab6ba28d87ff",
    "imageID": "71c3d6b7-3b14-40bc-845a-0a03083198c7",
    "syshdType": "SATA",
    "syshd": 40,
    "diskList":[
        {
            "title":"test-0929001",
            "diskMode":"VBD",
            "size":40,
            "type":"SATA"
        }
    ],
    "vpc": "vpc-3mfegx8jr",
    "secGroupList": [
        "sg-ozljb11yr1"
    ],
    "rootPassword": "sd123456",
    "networkCardList": [
        {
            "ipv6Change": "",
            "title": "",
            "master": true,
            "subnetID": "subnet-qnqc3b9m7j"
        }
    ],
    "extIP":"0"
}

请求示例代码

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' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "azName": "cn-gd-can3-2a-hybrid-industry",
    "onDemand": true,
    "regionID": "cn-gd-can3-hybrid-industry",
    "vmName": "test-0929001",
    "displayName": "test-0929001",
    "flavorID": "8c481a96-bfa0-0e68-4b9b-ab6ba28d87ff",
    "imageID": "71c3d6b7-3b14-40bc-845a-0a03083198c7",
    "syshdType": "SATA",
    "syshd": 40,
    "diskList":[
        {
            "title":"test-0929001",
            "diskMode":"VBD",
            "size":40,
            "type":"SATA"
        }
    ],
    "vpc": "vpc-3mfegx8jr",
    "secGroupList": [
        "sg-ozljb11yr1"
    ],
    "rootPassword": "sd123456",
    "networkCardList": [
        {
            "ipv6Change": "",
            "title": "",
            "master": true,
            "subnetID": "subnet-qnqc3b9m7j"
        }
    ],
    "extIP":"0"
}'

返回响应

🟢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-03-19 02:18:51

查询云主机备份列表-vdc

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