接口功能介绍

本接口提供用户在专属云中创建一台按量付费的云主机的功能
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
  计费模式：确认开通云主机的计费模式，详细查看计费模式
  地域选择：选择要创建云主机的专属云的资源池
  产品选型：购买弹性云主机前，请先阅读规格说明了解弹性云主机的选型基本信息，并通过查询一个或多个云主机规格资源接口，获取当前资源池可用云主机规格信息
  网络规划：规划云主机的网络环境，详细查看弹性云主机-网络
注意事项：
  成本估算：了解云主机的计费项
  用户配额：确认个人在不同资源池下资源配额，可以通过用户配额查询接口进行查询
  异步接口：该接口为异步接口，下单过后会拿到主订单ID（masterOrderID），后续可以调用根据masterOrderID查询云主机ID，使用主订单ID来对订单情况与开通成功后的资源ID进行查询
  单台创建：当前接口只能创建单台云主机
  监控安装：在云服务器创建成功后，3-5分钟内将完成详细监控Agent安装，即开启云服务器CPU，内存，网络，磁盘，进程等指标详细监控，若不开启，则无任何监控数据。

接口约束

  1. 目前不支持预付费账户创建按需付费类型云主机
  2. 专属云内创建云主机均为按需类型云主机
  3. 自动分配弹性IP（extIP="1"）时，需要填写弹性IP版本（ipVersion）与带宽大小（bandwidth）；使用已有的弹性IP（extIP="2"）时，需要填写弹性IP的版本（ipVersion）和对应弹性IP的ID（eipID或ipv6AddressID）
  4. 挂载网卡时，子网与虚拟私有云存在对应关系，确保子网属于当前虚拟私有云

URI

POST /v4/dec/create-instance

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

表 dataDiskList

表 networkCards

响应参数

表 returnObj

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例1：创建一台云主机，配置各项内容，不使用弹性公网IP
在专属云内，系统盘选普通IO类型、大小40GB，并增加20GB普通IO类型数据盘。
规格为s7.small.1，镜像为CentOS8.0 64位，并附带副网卡指定其名称和内网IP地址，并配置使用指定安全组，不使用弹性公网IP。
创建到指定专属宿主机上，并加入安全组，绑定密钥对
{
	"clientToken": "please_create_your_own_clientToken_not_use_dec_create_example_01",
	"instanceName": "api-test01",
	"displayName": "create-01",
	"imageType": 1,
	"bootDiskType": "SATA",
	"bootDiskSize": 40,
	"onDemand": true,
	"extIP": "0",
	"regionID": "a39b0db2989140c79e6de8c21d50f132",
	"azName": "cn-huadong1-jsnj3A-public-ctcloud",
	"flavorID": "0457fe14-6ffe-e739-87ad-93e43fc6dbfa",
	"imageID": "d39aba04-2470-4eea-acdc-10cb4f962588",
	"vpcID": "vpc-gg2ov4ryo5",
	"decHostID": "53cbad26-c4bc-34ff-2e89-80fc0940437f",
	"networkCardList": [{
		"subnetID": "subnet-5zt2og2t3h",
		"isMaster": true
	}, {
		"subnetID": "subnet-975wansb47",
		"isMaster": false,
		"nicName": "api-test1031",
		"fixedIP": "192.168.1.8"
	}],
	"dataDiskList": [{
		"diskMode": "VBD",
		"diskName": "disk-01",
		"diskSize": 20,
		"diskType": "SATA"
	}],
	"secGroupList": ["sg-1nni47y963"],
	"affinityGroupID": "daccb1e1-e2fd-a380-1b37-d9d6f581395e",
	"keyPairID": "d0d9d373-3ffa-17fc-38c9-93283a1eb800",
	"userPassword": "zxTest1031"
}
示例2：指定已有公网IP，创建云主机
在专属云内，系统盘选普通IO类型、大小40GB，指定ipv4类型弹性公网，
规格为s7.small.1，镜像为Ubuntu 18.04 64位。
{
	"clientToken": "please_create_your_own_clientToken_not_use_dec_create_example_02",
	"instanceName": "api-02",
	"displayName": "create-02",
	"imageType": 1,
	"bootDiskType": "SATA",
	"bootDiskSize": 40,
	"onDemand": true,
	"extIP": "2",
	"ipVersion": "ipv4",
	"eipID": "eip-trwi2vk023",
	"regionID": "a39b0db2989140c79e6de8c21d50f132",
	"azName": "cn-huadong1-jsnj3A-public-ctcloud",
	"flavorID": "0457fe14-6ffe-e739-87ad-93e43fc6dbfa",
	"imageID": "26ec204c-ebe5-47b9-bff9-32da77026228",
	"vpcID": "vpc-gg2ov4ryo5",
	"decHostID": "53cbad26-c4bc-34ff-2e89-80fc0940437f",
	"networkCardList": [{
		"subnetID": "subnet-5zt2og2t3h",
		"isMaster": true
	}]
}
示例3：自动分配公网IP，创建云主机
在专属云内，系统盘选普通IO类型、大小40GB，自动分配带宽大小为2Mbit/s的弹性公网，
规格为s7.small.1，镜像为Ubuntu 18.04 64位。
{
	"clientToken": "please_create_your_own_clientToken_not_use_dec_create_example_03",
	"instanceName": "api-03",
	"displayName": "create-03",
	"imageType": 1,
	"bootDiskType": "SATA",
	"bootDiskSize": 40,
	"onDemand": true,
	"extIP": "1",
	"ipVersion": "ipv4",
	"bandwidth": 2,
	"regionID": "a39b0db2989140c79e6de8c21d50f132",
	"azName": "cn-huadong1-jsnj3A-public-ctcloud",
	"flavorID": "0457fe14-6ffe-e739-87ad-93e43fc6dbfa",
	"imageID": "d39aba04-2470-4eea-acdc-10cb4f962588",
	"vpcID": "vpc-gg2ov4ryo5",
	"decHostID": "53cbad26-c4bc-34ff-2e89-80fc0940437f",
	"networkCardList": [{
		"subnetID": "subnet-5zt2og2t3h",
		"isMaster": true
	}]
}

响应示例

{
	"returnObj": {
		"masterResourceID": "39559b25eabf455481aa9e3882d3b0a7",
		"masterOrderNO": "20221202173339078653",
		"regionID": "ef901a5734964ce29eedac918c4716a3",
		"masterOrderID": "0ea2d572722311eda5fb0242ac110002"
	},
	"message": "SUCCESS",
	"description": "成功",
	"statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码