創建伸縮配置
更新時間 2025-03-12 11:20:28
最近更新時間: 2025-03-12 11:20:28
分享文章
創建一個彈性伸縮配置
接口功能介紹
創建一個彈性伸縮配置
接口約束
無
URI
POST /v4/scaling/config-create
路徑參數
無
Query參數
無
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池ID | 81f7728662dd11ec810800155d307d5b | |
| name | 是 | String | 伸縮配置名稱 | as-config-local001 | |
| imageID | 是 | String | 鏡像ID | b78812b0-ff50-4816-b58f-5c4fbc230b08 | |
| securityGroupIDList | 否 | Array of Strings | 安全組ID列表,非多可用區資源池該參數為必填 | ['sg-nd1h63d2j8'] | |
| specName | 是 | String | 規格名稱 | c6.large.2 | |
| volumes | 是 | Array of Objects | 磁盤類型和大小列表,元素為volume | [{'volumeType':'SATA', 'volumeSize':40,'flag':1}] | volume |
| useFloatings | 是 | Integer | 是否使用彈性IP。 取值范圍:1:不使用,2:自動分配 | 2 | |
| bandWidth | 否 | Integer | 彈性IP帶寬,單位:Mbps,useFloatings為2時必填,范圍1-3000 | 100 | |
| loginMode | 是 | Integer | 登錄方式。 取值范圍:1:密碼,2:密鑰對 | 2 | |
| username | 否 | String | 用戶名,loginMode為1時,必填 | root | |
| password | 否 | String | 密碼,loginMode為1時,必填 | ysdfdfgGG@ | |
| keyPairID | 否 | String | 密鑰對ID,loginMode為2時,必填 | 539b0666-d667-c71f-62b5-4db7a3cbdd59 | |
| userData | 否 | String | 用戶自定義數據,以Base64方式編碼 | ZWNobyBoZWxsbyBnb3N0YWNrIQ== | |
| tags | 否 | Array of Objects | 標簽集 | tag | |
| azNames | 否 | Array of Strings | 可用區列表,僅多可用區資源池支持,多可用區資源池該參數為必填 | ['az1', 'az2'] | |
| monitorService | 否 | Boolean | 是否開啟詳細監控,默認開啟。 取值范圍:true:開啟,false:關閉 | true |
表 volume
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| volumeType | 是 | String | 磁盤類型。取值范圍: SATA:普通IO,SAS:高IO,SSD:超高IO,FAST-SSD:極速型SSD |
SATA | |
| volumeSize | 是 | Integer | 磁盤大小,單位G | 40 | |
| flag | 是 | Integer | 磁盤類型。取值范圍:1:系統盤,2:數據盤。系統盤限制為1塊 | 1 |
表 tag
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| key | 是 | String | 標簽鍵 | key1 | |
| value | 是 | String | 標簽值 | value1 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回碼:800表示成功,900表示失敗 | 800 | |
| errorCode | String | 業務細分碼,為product.module.code三段式碼 | Scaling.Config.NotFound | 錯誤碼 |
| message | String | 失敗時的錯誤描述,一般為英文描述 | scaling config info not found | |
| description | String | 失敗時的錯誤描述,一般為中文描述 | 未找到彈性伸縮配置信息 | |
| returnObj | Object | 成功時返回的數據,參見表returnObj | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| id | Integer | 伸縮配置ID | 412 |
請求示例
請求頭header
無
請求體body
{
"name": "as-config-local2001",
"securityGroupIDList": [
"sg-nd1h63d2j8"
],
"keyPairID": "539b0666-d667-c71f-62b5-4db7a3cbdd59",
"imageID": "b78812b0-ff50-4816-b58f-5c4fbc230b08",
"bandWidth": 100,
"specName": "c6.large.2",
"volumes": [
{
"volumeType": "SATA",
"volumeSize": 40,
"flag": 1
}
],
"useFloatings": 2,
"loginMode": 2,
"tags": [
{
"key": "k0",
"value": "v0"
}
],
"regionID": "81f7728662dd11ec810800155d307d5b",
"azNames": ["az1", "az2"]
}
響應示例
{
"returnObj": {
"id": 412
},
"errorCode": "",
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
錯誤碼
| errorCode | 描述 |
|---|---|
| Scaling.Config.ConfigNumberMoreThanLimit | 彈性伸縮配置數量超過限制 |
| Scaling.Config.ConfigNameInvalid | 名稱錯誤,只能由數字、字母、-組成,不能以數字和-開頭、以-結尾,且長度為2-50字符 |
| Scaling.Config.FlavorNotFound | 未找到規格信息 |
| Scaling.Config.ImageNotFound | 未找到該鏡像信息 |
| Scaling.Config.DiskTypeNotSupported | 不支持的磁盤類型 |
| Scaling.Config.DiskCountQuotaLimited | 磁盤數目配額不足 |
| Scaling.Config.UseFloatingsNotSupported | 是否使用彈性公網IP |
| Scaling.Config.BillingModeNotSupported | 不支持該計費方式 |
| Scaling.Config.BandWidthInvalid | 無效的帶寬,范圍為[1-3000]Mbps |
| Scaling.Config.NotFound | 未找到彈性伸縮配置信息 |
| Scaling.Config.LoginModeNotSupported | 不支持該登錄方式 |
| Openapi.Workorder.AccessFailed | 系統錯誤 |
| Scaling.Parameter.InvalidError | 請求參數錯誤 |