文档首页/ 分布式缓存服务 DCS/ API参考/ API V2（推荐）/ 实例管理/ 更新实例带宽弹性伸缩策略
更新时间：2024-12-16 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新实例带宽弹性伸缩策略

功能介绍

更新实例带宽弹性伸缩策略。暂不支持实例带宽自动回缩。

调用方法

请参见如何调用API。

URI

PUT /v2/{project_id}/instances/{instance_id}/autoscaling-policy/bandwidth

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。

instance_id

是

String

实例ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

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

表3 响应Body参数

参数

参数类型

描述

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

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

状态码： 401

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

状态码： 403

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

状态码： 404

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

状态码： 500

表8 响应Body参数

参数

参数类型

描述

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

内部服务错误。

错误码

请参见错误码。

父主题： 实例管理

相关文档