更新实例带宽弹性伸缩策略
功能介绍
更新实例带宽弹性伸缩策略。暂不支持实例带宽自动回缩。
URI
PUT /v2/{project_id}/instances/{instance_id}/autoscaling-policy/bandwidth
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID。获取方法请参见获取项目ID。 |
instance_id | 是 | String | 实例ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
window_size | 是 | Integer | 带宽弹性的观测窗口，单位：分钟。支持的取值：1、5、10、15、30。 |
bandwidth_usage_upper_threshold | 是 | Integer | 触发带宽自动扩展的带宽平均使用率阈值，单位：百分比。支持的取值：50、60、70、80、90、95。 |
scale_out_cooldown | 是 | Integer | 带宽扩展操作的静默时间（两次带宽扩展操作之间的最小间隔时间），单位：秒。 默认值：0。取值范围：0~86400。 |
scale_in_enabled | 否 | Boolean | 是否启用带宽自动回缩。默认值：false。该参数暂未启用。 |
bandwidth_usage_lower_threshold | 否 | Integer | 触发带宽自动回缩的带宽平均使用率阈值，单位：百分比。支持的取值：10、20、30。该参数暂未启用。 |
scale_in_cooldown | 否 | Integer | 带宽回缩操作的静默时间（两次带宽回缩操作之间的最小间隔时间），单位：秒。该参数暂未启用。 默认值：300。取值范围：0~86400。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
window_size | Integer | 带宽弹性的观测窗口，单位：分钟。支持的取值：1、5、10、15、30。 |
bandwidth_usage_upper_threshold | Integer | 触发带宽自动扩展的带宽平均使用率阈值，单位：百分比。支持的取值：50、60、70、80、90、95。 |
scale_out_cooldown | Integer | 带宽扩展操作的静默时间（两次带宽扩展操作之间的最小间隔时间），单位：秒。 默认值：0。取值范围：0~86400。 |
scale_in_enabled | Boolean | 是否启用带宽自动回缩。默认值：false。该参数暂未启用。 |
bandwidth_usage_lower_threshold | Integer | 触发带宽自动回缩的带宽平均使用率阈值，单位：百分比。支持的取值：10、20、30。该参数暂未启用。 |
scale_in_cooldown | Integer | 带宽回缩操作的静默时间（两次带宽回缩操作之间的最小间隔时间），单位：秒。该参数暂未启用。 默认值：300。取值范围：0~86400。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_code | String | 参数解释： 错误码。 取值范围： 请参见错误码。 |
error_ext_msg | String | 参数解释： 扩展错误信息（暂未使用，赋值为null）。 取值范围： 不涉及。 |
状态码：401
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_code | String | 参数解释： 错误码。 取值范围： 请参见错误码。 |
error_ext_msg | String | 参数解释： 扩展错误信息（暂未使用，赋值为null）。 取值范围： 不涉及。 |
状态码：403
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_code | String | 参数解释： 错误码。 取值范围： 请参见错误码。 |
error_ext_msg | String | 参数解释： 扩展错误信息（暂未使用，赋值为null）。 取值范围： 不涉及。 |
状态码：404
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_code | String | 参数解释： 错误码。 取值范围： 请参见错误码。 |
error_ext_msg | String | 参数解释： 扩展错误信息（暂未使用，赋值为null）。 取值范围： 不涉及。 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_code | String | 参数解释： 错误码。 取值范围： 请参见错误码。 |
error_ext_msg | String | 参数解释： 扩展错误信息（暂未使用，赋值为null）。 取值范围： 不涉及。 |
请求示例
PUT https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/autoscaling-policy/bandwidth
{
"window_size" : 5,
"bandwidth_usage_upper_threshold" : 70,
"scale_out_cooldown" : 0,
"scale_in_enabled" : true,
"bandwidth_usage_lower_threshold" : 30,
"scale_in_cooldown" : 300
} 响应示例
状态码：200
更新实例弹性伸缩策略响应体。
{
"window_size" : 5,
"bandwidth_usage_upper_threshold" : 70,
"scale_out_cooldown" : 0,
"scale_in_enabled" : true,
"bandwidth_usage_lower_threshold" : 30,
"scale_in_cooldown" : 300
} 状态码：400
非法请求。
{
"error_code" : "DCS.4063",
"error_msg" : "Invalid window_size parameter in the request."
} 状态码
状态码 | 描述 |
|---|---|
200 | 更新实例弹性伸缩策略响应体。 |
400 | 非法请求。 |
401 | 认证信息非法。 |
403 | 请求被拒绝访问。 |
404 | 所请求的资源不存在。 |
500 | 内部服务错误。 |
错误码
请参见错误码。
