功能介紹
創(chuàng)建 彈性伸縮 配置。
- 伸縮配置是伸縮組內(nèi)實(shí)例（彈性 云服務(wù)器 ）的模板，定義了伸縮組內(nèi)待添加的實(shí)例的規(guī)格數(shù)據(jù)。
- 伸縮配置與伸縮組是解耦的，同一伸縮配置可以被多個伸縮組使用。
- 默認(rèn)最多可以創(chuàng)建100個伸縮配置。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /autoscaling-api/v1/{project_id}/scaling_configuration
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
|---|---|---|
|
instance_id |
否 |
String |
|
flavorRef |
否 |
String |
|
imageRef |
否 |
String |
|
disk |
否 |
|
|
key_name |
否 |
String |
|
personality |
否 |
|
|
public_ip |
否 |
|
|
user_data |
否 |
String |
|
metadata |
否 |
|
|
security_groups |
否 |
|
|
server_group_id |
否 |
String |
|
tenancy |
否 |
String |
|
dedicated_host_id |
否 |
String |
|
multi_flavor_priority_policy |
否 |
String |
|
market_type |
否 |
String |
對于Linux彈性云服務(wù)器，如果需要注入密碼，只能使用userdata進(jìn)行注入；對于Windows彈性云服務(wù)器，如果需要注入密碼，只能通過元數(shù)據(jù)admin_pass進(jìn)行注入。
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
size |
是 |
Integer |
磁盤大小，容量單位為GB。 系統(tǒng)盤輸入大小范圍為1~1024，且不小于 鏡像 中系統(tǒng)盤的最小(min_disk屬性)值。 數(shù)據(jù)盤輸入大小范圍為10~32768。 |
|
volume_type |
是 |
String |
云服務(wù)器系統(tǒng)盤對應(yīng)的磁盤類型，需要與系統(tǒng)所提供的磁盤類型相匹配。 目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”。
當(dāng)指定的云硬盤類型在avaliability_zone內(nèi)不存在時，則創(chuàng)建云硬盤失敗。 說明：
不同云服務(wù)器規(guī)格支持的磁盤類型不同，本文僅供參考，具體支持的磁盤類型請以控制臺界面顯示為準(zhǔn)。 說明：
|
|
disk_type |
是 |
String |
標(biāo)識系統(tǒng)盤還是數(shù)據(jù)盤，枚舉值如下：
|
|
dedicated_storage_id |
否 |
String |
云服務(wù)器的磁盤可指定創(chuàng)建在用戶的專屬存儲中，需要指定專屬存儲ID。 說明：
同一個伸縮配置中的磁盤需統(tǒng)一指定或統(tǒng)一不指定專屬存儲，不支持混用；當(dāng)指定專屬存儲時，所有專屬存儲需要屬于同一個可用區(qū)，且每個磁盤選擇的專屬存儲支持的磁盤類型都需要和參數(shù)volume_type保持一致。 |
|
data_disk_image_id |
否 |
String |
指定特定ID的數(shù)據(jù)盤鏡像，用以導(dǎo)出云服務(wù)器的數(shù)據(jù)盤。 |
|
snapshot_id |
否 |
String |
當(dāng)選擇使用整機(jī)鏡像時，云服務(wù)器的系統(tǒng)盤及數(shù)據(jù)盤將通過整機(jī)備份恢復(fù)，需要指定磁盤備份的快照ID。 說明：
磁盤備份的快照ID可通過鏡像的整機(jī)備份ID在CSBS查詢單個備份中獲得；一個伸縮配置中的每一個disk需要通過snapshot_id和整機(jī)備份中的磁盤備份一一對應(yīng)。 |
|
metadata |
否 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
__system__encrypted |
否 |
String |
metadata中的表示加密功能的字段，0代表不加密，1代表加密。 該字段不存在時，云硬盤默認(rèn)為不加密。 說明：
系統(tǒng)盤不支持加密。 |
|
__system__cmkid |
否 |
String |
用戶主密鑰ID，是metadata中的表示加密功能的字段，與__system__encrypted配合使用。 說明：
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
path |
是 |
String |
注入文件路徑信息。
|
|
content |
是 |
String |
注入文件內(nèi)容。 該值應(yīng)指定為注入文件的內(nèi)容進(jìn)行base64格式編碼后的信息。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
eip |
是 |
配置云服務(wù)器自動分配彈性IP時，創(chuàng)建彈性IP的配置參數(shù)。詳情請參考表 eip字段數(shù)據(jù)結(jié)構(gòu)說明。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
ip_type |
是 |
String |
彈性IP地址類型。 類型枚舉值：
詳情請參見《 虛擬私有云 接口參考》“申請 彈性公網(wǎng)IP ”章節(jié)的“publicip”字段說明。 |
|
bandwidth |
是 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
size |
否 |
Integer |
帶寬（Mbit/s），按帶寬分配取值范圍為[1,2000]，按流量分配取值范圍為[1,300]。 說明：
|
|
share_type |
是 |
String |
帶寬的共享類型。 共享類型枚舉：
|
|
charging_mode |
否 |
String |
帶寬的計費(fèi)類型。 計費(fèi)類型枚舉：
若字段為其它值，會導(dǎo)致創(chuàng)建云服務(wù)器失敗。
說明：
|
|
id |
否 |
String |
帶寬ID，使用共享型帶寬時，可以選擇之前創(chuàng)建的共享帶寬來創(chuàng)建彈性IP，詳情請見查詢帶寬列表。 說明：
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
admin_pass |
否 |
String |
如果需要使用密碼方式登錄云服務(wù)器，可使用adminPass字段指定云服務(wù)器管理員帳戶初始登錄密碼。其中，Linux管理員帳戶為root，Windows管理員帳戶為Administrator。 密碼復(fù)雜度要求：
|
請求示例
POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_configuration
{
"scaling_configuration_name": "as-config-tlzq",
"instance_config": {
"flavorRef": "s3.xlarge.4",
"imageRef": "627a1223-2ca3-46a7-8d5f-7aef22c74ee6",
"disk": [
{
"size": 40,
"volume_type": "SATA",
"disk_type": "SYS"
}
],
"key_name": "100vm_key" ,
"security_groups": [{
"id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
}],
"multi_flavor_priority_policy": "PICK_FIRST"
}
}
響應(yīng)參數(shù)
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
scaling_configuration_id |
String |
伸縮配置ID。 |
響應(yīng)示例
{
"scaling_configuration_id": "f8327883-6a07-4497-9a61-68c03e8e72a2"
}
返回值
- 正常
- 異常
返回值
說明
400 Bad Request
服務(wù)器未能處理請求。
401 Unauthorized
被請求的頁面需要用戶名和密碼。
403 Forbidden
對被請求的頁面訪問禁止。
404 Not Found
服務(wù)器無法找到被請求的頁面。
405 Method Not Allowed
請求中指定的方法不被允許。
406 Not Acceptable
服務(wù)器生成的響應(yīng)無法被客戶端所接受。
407 Proxy Authentication Required
用戶必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證，這樣請求才會被處理。
408 Request Timeout
請求超出了服務(wù)器的等待時間。
409 Conflict
由于沖突，請求無法被完成。
500 Internal Server Error
請求未完成。服務(wù)異常。
501 Not Implemented
請求未完成。服務(wù)器不支持所請求的功能。
502 Bad Gateway
請求未完成。服務(wù)器從上游服務(wù)器收到一個無效的響應(yīng)。
503 Service Unavailable
請求未完成。系統(tǒng)暫時異常。
504 Gateway Timeout
網(wǎng)關(guān)超時。
錯誤碼
請參考錯誤碼。
