接口功能介绍

使用已创建成功的云主机，克隆一台新的云主机。新云主机的规格、镜像、数据盘、系统盘及数据等均与备份一致。
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
  计费模式：确认开通云主机的计费模式，详细查看计费模式
  网络规划：规划云主机的网络环境，详细查看弹性云主机-网络
注意事项：
  成本估算：了解云主机的计费项
  用户配额：确认个人在不同资源池下资源配额，可以通过用户配额查询接口进行查询
  异步接口：该接口为异步接口，下单过后会拿到主订单ID（masterOrderID），后续可以调用根据masterOrderID查询云主机ID，使用主订单ID来对订单情况与开通成功后的资源ID进行查询
  企业项目：保证资源隔离，需确保所有资源与云主机处于相同企业项目下才可进行挂载操作，如网络资源：VPC、安全组、弹性IP、子网
  标签绑定：云主机绑定标签时，标签键和值存在的情况下，绑定对应标签；不存在的情况下，创建新的标签并绑定云主机。主机创建完成后，云主机变为运行状态，此时标签仍可能未绑定，需等待一段时间（0~10分钟）。新的云主机不会克隆原云主机的标签，如需标签请重新添加。
  监控安装：在云服务器创建成功后，3-5分钟内将完成详细监控Agent安装，即开启云服务器CPU，内存，网络，磁盘，进程等指标详细监控，若不开启，则无任何监控数据。

接口约束

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

URI

POST /v4/ecs/clone-instance

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

表 networkCardList

表 labelList

响应参数

表 returnObj

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例1：克隆一台云主机，按需计费（不使用密钥对、云主机组、弹性公网、自定义数据等内容，不挂载副网卡）
在华东1克隆一台云主机，并按需计费
{
    "regionID": "bb9fdb42056f11eda1610242ac110002",
	"extIP":"0",
	"instanceName":"Api-clone01",
	"displayName":"CloneTest01",
	"clientToken":"please_create_your_own_clientToken_here_not_use_clone_example_01",
	"networkCardList": [
        {
            "subnetID": "subnet-2bqqmpxt96", 
            "isMaster": true
        }
    ],
	"onDemand": true,
	"vpcID":"vpc-4f0sye7nn3",
	"instanceID": "df9974de-6d63-58d0-d895-ffe3af9c5716"
}
示例2：克隆一台云主机，并个性化配置网络（弹性公网、副网卡等）及其他信息（密钥对、云主机组等）
在华东1克隆一台云主机，包周期付费，购买六个月。增加副网卡，并指定内网IP与名称
自动分配公网IP、带宽为2，加入云主机组，绑定密钥对，使用自定义数据，指定项目ID。
后续自动续订
{
    "regionID": "bb9fdb42056f11eda1610242ac110002",
	"extIP":"1",
	"ipVersion": "ipv4",
	"bandwidth": 2,
	"instanceName":"Api-clone01",
	"displayName":"CloneTest01",
	"clientToken":"please_create_your_own_clientToken_here_not_use_clone_example_02",
  	"vpcID":"vpc-4f0sye7nn3",
	"networkCardList": [
        {
            "subnetID": "subnet-2bqqmpxt96", 
            "isMaster": true
        },
        {
            "subnetID": "subnet-3lrbkaj66a",
            "isMaster": false,
            "fixedIP": "192.168.0.17",
            "nicName": "nic-02"
        }
    ],
	"onDemand": false,
	"cycleType": "MONTH",
    "cycleCount": 6,
	"instanceID": "df9974de-6d63-58d0-d895-ffe3af9c5716",
	"keyPairID": "48edb5e9-c66a-3f74-907d-a45e771a8cef",
    "affinityGroupID": "924b95c4-68d9-3fbe-835d-fee46397feda",
    "projectID": "95e17b31e41e4d509687398baf91c260",
    "autoRenewStatus": 1,
    "userData": "b3BlbmFwaV91c2VyRGF0YV90ZXN0"
}
示例3：克隆一台云主机，指定使用已有公网IP
在华东1克隆一台云主机，指定使用已有公网IP，包周期付费，购买六个月。 
{
    "regionID": "bb9fdb42056f11eda1610242ac110002",
	"extIP":"2",
	"ipVersion": "ipv4",
	"eipID": "eip-9jpeyl0frh",
	"instanceName":"Api-clone01",
	"displayName":"CloneTest01",
	"clientToken":"please_create_your_own_clientToken_here_not_use_clone_example_02",
  	"vpcID":"vpc-4f0sye7nn3",
	"networkCardList": [
        {
            "subnetID": "subnet-2bqqmpxt96", 
            "isMaster": true
        }
    ],
	"onDemand": false,
	"cycleType": "MONTH",
    "cycleCount": 6,
	"instanceID": "df9974de-6d63-58d0-d895-ffe3af9c5716"
}

响应示例

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

状态码

请参考 状态码

错误码

请参考 错误码