接口功能介紹

本接口提供用戶在專屬云中創建一臺按量付費的云主機的功能
準備工作：
??構造請求：在調用前需要了解如何構造請求，詳情查看
??認證鑒權：openapi請求需要進行加密調用，詳細查看
??計費模式：確認開通云主機的計費模式，詳細查看計費模式
??地域選擇：選擇要創建云主機的專屬云的資源池
??產品選型：購買彈性云主機前，請先閱讀規格說明了解彈性云主機的選型基本信息，并通過接口，獲取當前資源池可用云主機規格信息

??網絡規劃：規劃云主機的網絡環境，詳細查看彈性云主機-網絡
注意事項：
??成本估算：了解云主機的計費項
??用戶配額：確認個人在不同資源池下資源配額，可以通過接口進行查詢
??異步接口：該接口為異步接口，下單過后會拿到主訂單ID（masterOrderID），后續可以調用，使用主訂單ID來對訂單情況與開通成功后的資源ID進行查詢
??單臺創建：當前接口只能創建單臺云主機
??監控安裝：在云服務器創建成功后，3-5分鐘內將完成詳細監控Agent安裝，即開啟云服務器CPU，內存，網絡，磁盤，進程等指標詳細監控，若不開啟，則無任何監控數據

接口約束

??1. 專屬云內創建云主機均為按需類型云主機
??2. 自動分配彈性IP（extIP="1"）時，需要填寫彈性IP版本（ipVersion）與帶寬大小（bandwidth）；使用已有的彈性IP（extIP="2"）時，需要填寫彈性IP的版本（ipVersion）和對應彈性IP的ID（eipID或ipv6AddressID）
??3. 掛載網卡時，子網與虛擬私有云存在對應關系，確保子網屬于當前虛擬私有云

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
}

狀態碼

請參考

錯誤碼

請參考