接口功能介紹

本接口提供用戶在專屬云中批量創建按量付費的云主機的功能
準備工作：
??構造請求：在調用前需要了解如何構造請求，詳情查看構造請求
??認證鑒權：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/batch-create-instance

路徑參數
無

Query參數
無

請求參數

請求頭header參數
無

請求體body參數

表 dataDiskList

表 networkCards

響應參數

表 returnObj

枚舉參數

無

請求示例

請求url

無

請求頭header

無

請求體body

示例1：創建2臺云主機，配置各項內容，自動分配彈性公網IP，設置帶寬為2Mbit/s。
在專屬云內，系統盤選超高IO類型、大小40GB，并增加40GB高IO類型數據盤。
規格為s7.small.1，鏡像為CTyunOS-3_23.01-x86_64_20240926。
主網卡指定內網IP地址，并配置使用指定安全組，加入指定云主機組，設置密碼。
{
    "regionID": "7fbbfa0a349241cbb476c492ef1cea20",
    "azName": "az1",
    "instanceName": "test1605",
    "displayName": "test11605",
    "flavorID": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
    "imageType": 1,
    "imageID": "0a50ee7b-a91a-4b8f-afe5-1508ce53578c",
    "vpcID": "vpc-umcq94wcc2",
    "bootDiskType": "SSD",
    "bootDiskSize": 40,
    "extIP": "1",
    "onDemand": true,
    "userPassword":"HelloCtyun.13",
    "projectID":"0",
    "secGroupList":["sg-cpel83ehwl"],
    "networkCardList": [
        {
            "subnetID": "subnet-con3h8n36g",
            "isMaster": true,
            "fixedIP":"10.0.0.123"
        }
    ],
    "dataDiskList": [
        {
            "diskType":"SAS",
            "diskSize":40,
            "diskMode":"VBD",
            "diskName":"test-data-yul-test1605"
        }
    ],
    "ipVersion":"ipv4",
    "bandwidth":2,
    "affinityGroupID":"e89c5ce9-8e72-4a9b-b963-2fe7c5f6254a",
	"userPassword": "Test1556",
    "monitorService": false,
    "orderCount":2,
    "clientToken": "9fc6fa0de-ebe7-4168-9ea2-802sdware18101644"
}
示例2：
創建2臺云主機，配置各項內容，不使用彈性公網IP。
系統盤指定專屬存儲池選擇超高IO類型、大小40GB，并增加一塊指定專屬存儲池選擇高IO類型、大小40G的數據盤。
規格為s7.small.1，鏡像為CTyunOS-3_23.01-x86_64_20240926
{
    "regionID": "7fbbfa0a349241cbb476c492ef1cea20",
    "azName": "az1",
    "instanceName": "test1051",
    "displayName": "test1051",
    "flavorID": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
    "imageType": 1,
    "imageID": "0a50ee7b-a91a-4b8f-afe5-1508ce53578c",
    "vpcID": "vpc-umcq94wcc2",
    "bootDiskType": "SSD",
    "bootDiskSize": 40,
    "extIP": "0",
    "onDemand": true,
    "userPassword":"HelloCtyun.13",
    "affinityGroupID":"",
    "projectID":"0",
    "secGroupList":null,
    "networkCardList": [
        {
            "subnetID": "subnet-con3h8n36g",
            "isMaster": true
        }
    ],
    "dataDiskList": [
        {
            "diskType":"SAS",
            "diskSize":40,
            "decTypeID":"26f82b6f-59f1-4cda-b608-0cd366a2eb9e"
        }
    ],
    "ipVersion":"ipv4",
    "bandwidth":2,
    "monitorService": false,
    "decTypeID":"9d8aa7d3-4fef-40dc-b2e2-6692b5ae8e34",
    "orderCount":2,
    "clientToken": "9fc6fa0de-ebe7-4168-9ea2-802sdware18101104"
}

響應示例

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

狀態碼

請參考

錯誤碼

請參考