功能介紹
創(chuàng)建一臺或多臺 云服務(wù)器 。
V1.1版本創(chuàng)建云服務(wù)器的接口兼容了V1版本創(chuàng)建云服務(wù)器（按需）的功能，同時(shí)合入新功能，支持創(chuàng)建包年/包月的彈性云服務(wù)器。
本接口為異步接口，當(dāng)前創(chuàng)建云服務(wù)器請求下發(fā)成功后會返回job_id，此時(shí)創(chuàng)建云服務(wù)器并沒有立即完成，需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表云服務(wù)器創(chuàng)建成功。
本接口支持在HTTP請求消息頭中設(shè)置X-Client-Token請求頭，保證請求冪等性。詳細(xì)信息請參考請求冪等性說明。
- 密鑰對
指使用密鑰對作為彈性云服務(wù)器的鑒權(quán)方式。
接口調(diào)用方法：使用key_name字段，指定彈性云服務(wù)器登錄時(shí)使用的密鑰文件，key_name字段的使用方法請參見表2。
- 密碼
指使用設(shè)置初始密碼方式作為彈性云服務(wù)器的鑒權(quán)方式，此時(shí)，您可以通過用戶名密碼方式登錄彈性云服務(wù)器，Linux操作系統(tǒng)時(shí)為root用戶的初始密碼，Windows操作系統(tǒng)時(shí)為Administrator用戶的初始密碼。
接口調(diào)用方法：使用adminPass字段，指定管理員帳號的初始登錄密碼，adminPass字段的使用方法請參見表2。對于 鏡像 已安裝Cloud-init的Linux云服務(wù)器，如果需要使用密文密碼，可以使用user_data字段進(jìn)行密碼注入，具體請參見表2。
對于安裝Cloud-init鏡像的Linux云服務(wù)器，若指定user_data字段，則adminPass字段無效。
- 鏡像密碼
使用Linux操作系統(tǒng)私有鏡像創(chuàng)建云服務(wù)器，支持使用私有鏡像的密碼。
接口調(diào)用方法：使用鏡像密碼，則無需指定key_name、adminPass字段。
購買操作示例：
接口約束
- 創(chuàng)建包年/包月云服務(wù)器時(shí)，支持自動(dòng)支付和手動(dòng)支付。
- 如果將請求中的isAutoPay字段設(shè)置為true，表示采用自動(dòng)支付方式，系統(tǒng)會自動(dòng)匹配賬戶支持的付款方式進(jìn)行扣費(fèi)。
- 自動(dòng)支付支持的付款方式和順序如下：
折扣優(yōu)惠（每次只能使用一項(xiàng)）→代金券（每次只能使用一張）→現(xiàn)金券或儲值卡（每次可使用多張，可同時(shí)使用）→賬戶余額（先扣現(xiàn)金額度后扣信用額度）或月末結(jié)算
- 如果上述付款方式無法完成支付，系統(tǒng)會自動(dòng)生成一個(gè)待支付訂單，您可以手動(dòng)在控制臺上選擇支付方式進(jìn)行支付。
自動(dòng)支付的更多內(nèi)容請參見自動(dòng)支付。
- 自動(dòng)支付支持的付款方式和順序如下：
- 如果將請求中的isAutoPay字段設(shè)置為false，表示采用手動(dòng)支付方式，系統(tǒng)會自動(dòng)生成一個(gè)待支付訂單，您可以手動(dòng)在控制臺上選擇支付方式進(jìn)行支付。
- 如果將請求中的isAutoPay字段設(shè)置為true，表示采用自動(dòng)支付方式，系統(tǒng)會自動(dòng)匹配賬戶支持的付款方式進(jìn)行扣費(fèi)。
- 創(chuàng)建按需計(jì)費(fèi)云服務(wù)器時(shí)，系統(tǒng)會自動(dòng)匹配適用的代金券進(jìn)行使用。
- 如果您需要退訂該包年/包月資源，請參考“退訂包年/包月資源”。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
- URI格式
- 參數(shù)說明
參數(shù)
是否必選
描述
project_id
是
項(xiàng)目ID
獲取方法請參見 獲取項(xiàng)目ID
請求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
server |
是 |
Object |
|
|
dry_run |
否 |
Boolean |
是否只預(yù)檢此次請求，默認(rèn)為false。
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
imageRef |
是 |
String |
待創(chuàng)建云服務(wù)器的系統(tǒng)鏡像，需要指定已創(chuàng)建鏡像的ID，ID格式為通用唯一識別碼（Universally Unique Identifier，簡稱UUID）。 |
|
flavorRef |
是 |
String |
待創(chuàng)建云服務(wù)器的系統(tǒng)規(guī)格的ID。 已上線的規(guī)格請參見《彈性云服務(wù)器產(chǎn)品介紹》的“實(shí)例類型與規(guī)格”章節(jié)。 |
|
name |
是 |
String |
云服務(wù)器名稱。 創(chuàng)建的云服務(wù)器數(shù)量（count字段對應(yīng)的值）等于1時(shí)，云服務(wù)器名稱只能由中文字符、英文字母、數(shù)字及“_”、“-”組成，且長度為[1-64]個(gè)字符。 創(chuàng)建的云服務(wù)器數(shù)量（count字段對應(yīng)的值）大于1時(shí)，可以使用“自動(dòng)排序”和“正則排序”設(shè)置有序的云服務(wù)器名稱。 請參考創(chuàng)建多臺云服務(wù)器云主機(jī)時(shí)怎樣設(shè)置有序的云服務(wù)器云主機(jī)名稱？ 取值范圍：
|
|
user_data |
否 |
String |
創(chuàng)建云服務(wù)器過程中待注入實(shí)例自定義數(shù)據(jù)。支持注入文本、文本文件。 說明：
更多關(guān)于待注入實(shí)例自定義數(shù)據(jù)的信息，請參見《彈性云服務(wù)器用戶指南 》的“用戶數(shù)據(jù)注入”章節(jié)。 示例： base64編碼前：
base64編碼后：
|
|
adminPass |
否 |
String |
如果需要使用密碼方式登錄云服務(wù)器，可使用adminPass字段指定云服務(wù)器管理員帳戶初始登錄密碼。其中，Linux管理員帳戶為root，Windows管理員帳戶為Administrator。 密碼復(fù)雜度要求：
|
|
key_name |
否 |
String |
如果需要使用SSH密鑰方式登錄云服務(wù)器，請指定已創(chuàng)建密鑰的名稱。 密鑰可以通過密鑰創(chuàng)建接口進(jìn)行創(chuàng)建（請參見創(chuàng)建和導(dǎo)入SSH密鑰），或使用SSH密鑰查詢接口查詢已有的密鑰（請參見查詢SSH密鑰列表 ）。 約束： 當(dāng)創(chuàng)建云服務(wù)器的extendparam字段中chargingMode為prePaid時(shí)（即包年包月的彈性云服務(wù)器），key_name參數(shù)必須配合metadata字段使用。詳情請參見創(chuàng)建云服務(wù)器的metadata字段數(shù)據(jù)結(jié)構(gòu)說明，以及請求示例1。 |
|
vpcid |
是 |
String |
待創(chuàng)建云服務(wù)器所屬 虛擬私有云 （簡稱VPC），需要指定已創(chuàng)建VPC的ID，UUID格式。 |
|
nics |
是 |
Array of objects |
待創(chuàng)建云服務(wù)器的網(wǎng)卡信息。詳情請參見表3 約束：
|
|
publicip |
否 |
Object |
配置云服務(wù)器的彈性IP信息，彈性IP有三種配置方式。
|
|
count |
否 |
Integer |
創(chuàng)建云服務(wù)器數(shù)量。 約束：
|
|
isAutoRename |
否 |
Boolean |
云服務(wù)器名稱是否允許重名。默認(rèn)為False，當(dāng)count大于1的時(shí)候該參數(shù)生效。
|
|
root_volume |
是 |
Object |
云服務(wù)器對應(yīng)系統(tǒng)盤相關(guān)配置。 創(chuàng)建包年/包月的彈性云服務(wù)器的時(shí)候，創(chuàng)建的系統(tǒng)盤/數(shù)據(jù)盤也是包年/包月，周期和彈性云服務(wù)器一致 |
|
data_volumes |
否 |
Array of objects |
云服務(wù)器對應(yīng)數(shù)據(jù)盤相關(guān)配置。每一個(gè)數(shù)據(jù)結(jié)構(gòu)代表一塊待創(chuàng)建的數(shù)據(jù)盤。 約束：目前彈性云服務(wù)器最多可掛載59塊數(shù)據(jù)盤(部分規(guī)格只支持23塊數(shù)據(jù)盤） |
|
security_groups |
否 |
Array of objects |
云服務(wù)器對應(yīng)安全組信息。 約束：當(dāng)該值指定為空時(shí)，默認(rèn)給云服務(wù)器綁定default安全組。 |
|
availability_zone |
否 |
String |
待創(chuàng)建云服務(wù)器所在的可用區(qū)，需要指定可用分區(qū)名稱。 說明：
如果為空，會自動(dòng)指定一個(gè)符合要求的可用區(qū)。 可通過接口 查詢可用區(qū)列表 獲取，也可參考地區(qū)和終端節(jié)點(diǎn)獲取。 |
|
batch_create_in_multi_az |
否 |
Boolean |
是否支持隨機(jī)多AZ部署，默認(rèn)為false。
當(dāng)availability_zone為空時(shí)該字段生效。 |
|
extendparam |
否 |
Object |
創(chuàng)建云服務(wù)器附加信息。 詳情請參見表9 |
|
metadata |
否 |
Map<String,String> |
創(chuàng)建云服務(wù)器元數(shù)據(jù)。 可以通過元數(shù)據(jù)自定義鍵值對。 說明：
系統(tǒng)預(yù)留鍵值對請參見表11。 |
|
os:scheduler_hints |
否 |
Object |
云服務(wù)器調(diào)度信息，例如設(shè)置云服務(wù)器組。 詳情請參見表12。 |
|
tags |
否 |
Array of strings |
彈性云服務(wù)器的標(biāo)簽。 標(biāo)簽的格式為“key.value”。其中，key的長度不超過36個(gè)字符，value的長度不超過43個(gè)字符。 標(biāo)簽命名時(shí)，需滿足如下要求：
說明：
|
|
server_tags |
否 |
Array of objects |
彈性云服務(wù)器的標(biāo)簽。詳情請參見server_tags字段數(shù)據(jù)結(jié)構(gòu)說明 說明：
|
|
description |
否 |
String |
云服務(wù)器描述信息，默認(rèn)為空字符串。
|
|
auto_terminate_time |
否 |
String |
該字段尚不支持，功能即將上線，敬請期待。 自動(dòng)釋放時(shí)間。 按照ISO8601標(biāo)準(zhǔn)表示，并使用UTC +0時(shí)間，格式為yyyy-MM-ddTHH:mm:ssZ。 如果秒（ss）取值不是 00，則自動(dòng)取為當(dāng)前分鐘（mm）開始時(shí)。 最短釋放時(shí)間為當(dāng)前時(shí)間半小時(shí)之后。 最長釋放時(shí)間不能超過當(dāng)前時(shí)間三年。 示例：2020-09-25T12:05:00Z 說明：
僅按需實(shí)例支持設(shè)置自動(dòng)釋放時(shí)間。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
待創(chuàng)建云服務(wù)器所在的子網(wǎng)信息。 需要指定vpcid對應(yīng)VPC下已創(chuàng)建的子網(wǎng)（subnet）的網(wǎng)絡(luò)ID，UUID格式。 可以通過VPC服務(wù)查詢子網(wǎng)列表接口查詢。 |
|
ip_address |
否 |
String |
待創(chuàng)建云服務(wù)器網(wǎng)卡的IP地址，IPv4格式。 約束：
|
|
ipv6_enable |
否 |
Boolean |
是否支持ipv6。取值為true時(shí)，表示此網(wǎng)卡支持ipv6。 |
|
ipv6_bandwidth |
否 |
Object |
綁定的共享帶寬信息，詳情請參見ipv6_bandwidth字段數(shù)據(jù)結(jié)構(gòu)說明。 |
|
allowed_address_pairs |
否 |
約束：IP地址不允許為 “0.0.0.0/0”
|
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
ip_address |
否 |
String |
IP地址。 約束：不支持0.0.0.0/0 如果allowed_address_pairs配置地址池較大的CIDR（掩碼小于24位），建議為該port配置一個(gè)單獨(dú)的安全組。 |
|
mac_address |
否 |
String |
MAC地址。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
volumetype |
是 |
String |
云服務(wù)器系統(tǒng)盤對應(yīng)的磁盤類型，需要與系統(tǒng)所提供的磁盤類型相匹配。 目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”。
當(dāng)指定的云硬盤類型在avaliability_zone內(nèi)不存在時(shí)，則創(chuàng)建云硬盤失敗。 說明：
|
|
size |
否 |
Integer |
系統(tǒng)盤大小，容量單位為GB， 輸入大小范圍為[1,1024]。 約束：
|
|
extendparam |
否 |
Object |
磁盤的產(chǎn)品信息。 |
|
cluster_type |
否 |
String |
云服務(wù)器系統(tǒng)盤對應(yīng)的磁盤存儲類型。 磁盤存儲類型枚舉值：DSS（專屬存儲類型） 該參數(shù)需要與“cluster_id”配合使用，僅當(dāng)“cluster_id”不為空時(shí)，才可以成功創(chuàng)建專屬存儲類型的磁盤。 |
|
cluster_id |
否 |
String |
云服務(wù)器系統(tǒng)盤對應(yīng)的存儲池的ID。 |
|
hw:passthrough |
否 |
Boolean |
設(shè)置云硬盤的設(shè)備類型：
說明：
非擎天規(guī)格僅支持設(shè)置系統(tǒng)盤為VBD類型。 |
|
metadata |
否 |
Object |
創(chuàng)建云硬盤的metadata信息，metadata中的key和value長度不大于255個(gè)字節(jié)。 僅在創(chuàng)建加密盤時(shí)使用metadata字段。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
volumetype |
是 |
String |
云服務(wù)器數(shù)據(jù)盤對應(yīng)的磁盤類型，需要與系統(tǒng)所提供的磁盤類型相匹配。 目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”。
當(dāng)指定的云硬盤類型在avaliability_zone內(nèi)不存在時(shí)，則創(chuàng)建云硬盤失敗。 說明：
|
|
size |
是 |
Integer |
數(shù)據(jù)盤大小，容量單位為GB，輸入大小范圍為[10,32768]。 如果使用數(shù)據(jù)盤鏡像創(chuàng)建數(shù)據(jù)盤時(shí)，size取值不能小于創(chuàng)建數(shù)據(jù)盤鏡像的源數(shù)據(jù)盤的大小。 |
|
shareable |
否 |
Boolean |
是否為共享磁盤。true為共享盤，false為普通云硬盤。 說明：
該字段已廢棄，請使用multiattach。 |
|
multiattach |
否 |
Boolean |
創(chuàng)建共享磁盤的信息。
說明：
|
|
hw:passthrough |
否 |
Boolean |
設(shè)置云硬盤的設(shè)備類型：
說明：
非擎天規(guī)格僅支持設(shè)置系統(tǒng)盤為VBD類型。 |
|
extendparam |
否 |
Object |
磁盤的產(chǎn)品信息。 詳情請參見表7。 |
|
cluster_type |
否 |
String |
云服務(wù)器數(shù)據(jù)盤對應(yīng)的磁盤存儲類型。 磁盤存儲類型枚舉值：DSS（專屬存儲類型） 該參數(shù)需要與“cluster_id”配合使用，僅當(dāng)“cluster_id”不為空時(shí)，才可以成功創(chuàng)建專屬存儲類型的磁盤。 |
|
cluster_id |
否 |
String |
云服務(wù)器數(shù)據(jù)盤對應(yīng)的存儲池的ID。 |
|
data_image_id |
否 |
String |
數(shù)據(jù)鏡像的ID，UUID格式。 如果使用數(shù)據(jù)盤鏡像創(chuàng)建數(shù)據(jù)盤，則data_image_id為必選參數(shù)，且不支持使用metadata。 |
|
metadata |
否 |
Object |
創(chuàng)建云硬盤的metadata信息，metadata中的key和value長度不大于255個(gè)字節(jié)。 僅在創(chuàng)建加密盤時(shí)使用metadata字段。 如果使用數(shù)據(jù)盤鏡像創(chuàng)建數(shù)據(jù)盤，不支持使用metadata。 |
|
delete_on_termination |
否 |
Boolean |
數(shù)據(jù)盤隨實(shí)例釋放策略
默認(rèn)值：false 說明：
該字段僅按需、競價(jià)實(shí)例支持。 |
響應(yīng)消息
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
job_id |
String |
提交任務(wù)成功后返回的任務(wù)ID，用戶可以使用該ID對任務(wù)執(zhí)行情況進(jìn)行查詢。如何根據(jù)job_id來查詢Job的執(zhí)行狀態(tài)，請參考查詢Job狀態(tài)。 |
|
order_id |
String |
訂單號，創(chuàng)建包年包月的彈性云服務(wù)器時(shí)返回該參數(shù)。 說明：
|
|
serverIds |
Array of strings |
云服務(wù)器ID列表。 說明：
通過云服務(wù)器ID查詢云服務(wù)器詳情 ，若返回404 可能云服務(wù)器還在創(chuàng)建或者已經(jīng)創(chuàng)建失敗。 |
異常響應(yīng)請參考響應(yīng)（任務(wù)類），異常響應(yīng)要素說明。
請求示例
- 創(chuàng)建一臺包年/包月云服務(wù)器，操作系統(tǒng)為CentOS 7.6 64bit，1U1G，綁定1M帶寬的 彈性公網(wǎng)IP ，采用密鑰方式登錄鑒權(quán)。
POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } - 創(chuàng)建一臺包年/包月云服務(wù)器，操作系統(tǒng)為CentOS 7.6 64bit，1U1G，綁定1M帶寬的彈性 公網(wǎng)IP ，采用密碼方式登錄鑒權(quán)。
POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "adminPass": "P@ssw0rd123", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "", "count": 1, "metadata": {}, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } - 創(chuàng)建一臺包年/包月云服務(wù)器，操作系統(tǒng)為CentOS 7.6 64bit，1U1G，綁定1M帶寬的按需按流量計(jì)費(fèi)的彈性公網(wǎng)IP，采用密鑰方式登錄鑒權(quán)。
POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER", "chargemode": "traffic" }, "extendparam": { "chargingMode": "postPaid" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } - 創(chuàng)建一臺包年/包月云服務(wù)器，操作系統(tǒng)為CentOS 7.6 64bit，1U1G，綁定共享帶寬的彈性公網(wǎng)IP，采用密鑰方式登錄鑒權(quán)。
POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "id": "a0d4b26f-699d-49a0-bcc8-6f707a925abf", "sharetype": "WHOLE" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166", "agency_name": "test" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } }
- 發(fā)送預(yù)校驗(yàn)請求，檢查創(chuàng)建云服務(wù)器的請求消息是否填寫了必選參數(shù)，請求格式是否正確。
POST https://{endpoint}/v1.1/{project_id}/cloudservers { "dry_run": true, "server": { "availability_zone":"az1-dc1", "name": "server", "imageRef": "ff49b1f1-3e3e-4913-89c6-a026041661e8", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.large.2", "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", "security_groups": [ { "id": "507ca48f-814c-4293-8706-300564d54620" } ], "nics": [ { "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83" } ], "key_name": "sshkey-123" } }
響應(yīng)示例
{
"job_id": "ff808082739334d80173943ec9b42130",
"order_id": "CS2007281506xxxxx",
"serverIds": [
"fe0528f0-5b1c-4c8c-9adf-e5d5047b8c17",
"679854ae-a50d-40c9-8132-b19bf3a306a1"
]
}
或
{
"error": {
"code": "Ecs.0005",
"message": "request body is illegal."
}
}
或
{
"error": {
"message": "privateIp [%s] is not in this subnet [%s]",
"code": "Ecs.0005",
"details": [
{
"code": "Ecs.0039"
}
]
}
}
返回值
請參考通用請求返回值。
錯(cuò)誤碼
請參考錯(cuò)誤碼。
