克隆云主机

POST

/v4/ecs/clone-instance

被克隆云主机存在，且云主机处于运行中（running）或关机（stopped）状态

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

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

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

云主机已挂载的云硬盘状态不能处于“镜像制作中”

请求参数

Header 参数

Body 参数application/json

示例

{
    "clientToken": "906a8508-c875-3598-2208-20221a8968e7",
    "regionID": "nm8",
    "onDemand": false,
    "instanceID": "463c3d1c-8eae-fe1d-d5db-806e336dc010",
    "instanceName": "test-clone0927001",
    "displayName": "test-clone0927001",
    "vpcID": "vpc-q63pkp6zuw",
    "networkCardList": [
        {
            "subnetID": "subnet-714nkryvjv",
            "isMaster": true,
            "nicName": "test-nic0728001",
            "fixedIP": ""
        }
    ],
    "extIP": "0",
    "secGroupList": [
        "sg-svrirhal6p"
    ],
    "userPassword": "M4ssQrm0*"
}

请求示例代码

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/clone-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": "906a8508-c875-3598-2208-20221a8968e7",
    "regionID": "nm8",
    "onDemand": false,
    "instanceID": "463c3d1c-8eae-fe1d-d5db-806e336dc010",
    "instanceName": "test-clone0927001",
    "displayName": "test-clone0927001",
    "vpcID": "vpc-q63pkp6zuw",
    "networkCardList": [
        {
            "subnetID": "subnet-714nkryvjv",
            "isMaster": true,
            "nicName": "test-nic0728001",
            "fixedIP": ""
        }
    ],
    "extIP": "0",
    "secGroupList": [
        "sg-svrirhal6p"
    ],
    "userPassword": "M4ssQrm0*"
}'

返回响应

🟢200成功

application/json

Body

示例

成功示例成功示例

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

修改于 2026-01-06 01:15:47

批量退订或销毁云主机