接口功能介绍

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

接口约束

  1. 使用限制，本接口只支持在拉萨3、上海7、广州6、郴州2、长沙3、北京5、内蒙6、南京3、重庆2、合肥2、成都4、晋中、昆明2、乌鲁木齐27、福州25、衡阳3、长沙37、张家界2、华北2、央企北京1、华东1、上海32、上海33、上海36资源池进行公测
  2. 至少存在一个备份
  3. 备份的状态为可用
  4. 目前不支持预付费账户创建按需付费类型云主机
  5. 计费模式选择包年包月计费方式时，需要填写订购周期类型与订购时长
  6. 自动分配弹性IP（extIP="1"）时，需要填写弹性IP版本（ipVersion）与带宽大小（bandwidth）；使用已有的弹性IP（extIP="2"）时，需要填写弹性IP的版本（ipVersion），和对应弹性IP的ID（eipID或ipv6AddressID）
  7. 挂载网卡时，子网与虚拟私有云存在对应关系，确保子网是虚拟私有云下的IP地址块
  8. 云主机绑定多个标签时，标签键（参数labelKey）不可重复，单台云主机最多可绑定10个标签

URI

POST /v4/ecs/backup/create-instance

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

表 networkCardList

表 labelList

响应参数

表 returnObj

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例：云主机的备份副本创建一台包年包月云主机，云主机所在的资源池为华东1可用区1，计费方式为包年包月，购买时长六个月，到期自动续订三个月
新创建云主机使用的规格、镜像、系统盘和数据盘与备份副本中的信息保持一致，备份副本中的镜像为：CTyunOS 2.0.1 64位，规格为：s7.small.1，
40 GiB SATA云系统盘，挂载20 GiB SATA云数据盘，公网出带宽为10 Mbit/s，自动分配公网IPv4地址，绑定主网卡，自动分配内网IPv4地址，
加入Default-Security-Group安全组，使用强制反亲和云主机组，使用代金券20.55支付金额，实例名称为apiCreate-test，登录密码为HelloCtyun.13，
数量一台，加入默认企业项目，增加一组标签。
{
	"regionID": "bb9fdb42056f11eda1610242ac110002",
	"instanceBackupID":"ecd49382-8280-4d1a-8d87-2a4c004ee78d",
	"instanceName": "apiCreate-test",
	"displayName": "apiNew-06",
	"vpcID": "vpc-ttxdh00rjf",
	"secGroupList":["sg-ulk99r4wja"],
	"affinityGroupID":"924b95c4-68d9-3fbe-835d-fee46397feda",
	"networkCardList": [{
		"subnetID": "subnet-ty87lkna06",
		"isMaster": true
	}],
	"extIP": "1",
	"bandwidth":10,
    "ipVersion":"ipv4",
	"onDemand": false,
	"cycleCount": 6,
	"cycleType": "MONTH",
	"userPassword":"HelloCtyun.13",
	"clientToken": "createTest1301",
	"payVoucherPrice": 20.55,
	"autoRenewStatus": 1,
    "labelList": [{
		"labelKey": "test-label",
		"labelValue": "test-value"
	}]
}

响应示例

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

状态码

请参考 状态码

错误码

请参考 错误码