创建伸缩配置
更新时间 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 | 请求参数错误 |
