调用ModifyAutoScalingConfig接口,修改实例弹性伸缩功能配置。
接口说明
API支持修改数据库实例的规格弹性伸缩功能、存储自动扩容功能、带宽弹性伸缩功能、分片弹性伸缩功能以及资源弹性伸缩功能:
以下目标数据库实例支持修改规格弹性伸缩功能:
以下目标数据库实例支持修改存储自动扩容功能:
- RDS MySQL高可用云盘实例,功能介绍及费用说明参见自动空间扩展。
以下目标数据库实例支持修改带宽弹性伸缩功能:
- Redis本地盘实例,功能介绍及费用说明参见自动调整带宽。
以下目标数据库实例支持修改分片弹性伸缩功能:
- Redis云盘社区版集群架构,功能介绍及费用说明参见自动增加分片。
以下目标数据库实例支持修改资源弹性伸缩功能:
- RDS MySQL高可用本地盘版(通用型)和三节点企业版(通用型),功能介绍及费用说明参见自动性能扩展。
使用阿里云或DAS的SDK时,建议使用最新版本。
在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
hdm:ModifyAutoScalingConfig | Write |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 实例ID。 | rm-2ze8g2am97624**** |
Spec | object | 否 | 规格弹性伸缩功能配置项。 | |
Apply | boolean | 否 | 是否应用规格弹性伸缩功能配置项Spec下的配置:
| true |
Upgrade | boolean | 否 | 是否开启规格自动扩容:
| true |
CpuUsageUpperThreshold | integer | 否 | 触发规格自动扩容的CPU平均利用率阈值,单位为%,取值:
注意目标数据库实例为PolarDB MySQL集群版、RDS MySQL高可用云盘版时,需要设置本参数。
| 70 |
MemUsageUpperThreshold | integer | 否 | 触发规格自动扩容的内存平均利用率阈值,单位为%,取值:
注意目标数据库实例为中国站Redis社区云盘版时,需要设置本参数。
| 70 |
MaxSpec | string | 否 | polar.mysql.x8.12xlarge | |
MaxReadOnlyNodes | integer | 否 | 实例只读节点数的最大值。
注意目标数据库实例为PolarDB MySQL集群版时,需要设置本参数。
| 10 |
ObservationWindowSize | string | 否 | 观测窗口。参数值由数值和时间单位后缀组成,支持的数据库实例及其取值如下,其中时间后缀m表示分钟,h表示小时:
| 5m |
CoolDownTime | string | 否 | 静默期。参数值由数值和时间单位后缀组成,支持的数据库实例及其取值如下,其中时间单位后缀m表示分钟,h表示小时,d:表示天:
| 5m |
Downgrade | boolean | 否 | 是否开启规格自动回缩:
注意目标数据库实例为PolarDB MySQL集群版、RDS MySQL高可用云盘版时,需要设置本参数。
| true |
Storage | object | 否 | 存储自动扩容功能配置项。 | |
Apply | boolean | 否 | 是否应用存储自动扩容功能配置项Storage下的配置:
| true |
Upgrade | boolean | 否 | 是否开启存储自动扩容:
| true |
DiskUsageUpperThreshold | integer | 否 | 触发存储自动扩容的存储空间平均利用率阈值,单位为%,取值:
| 70 |
MaxStorage | integer | 否 | 32000 | |
Bandwidth | object | 否 | 带宽弹性伸缩功能配置项。 | |
Apply | boolean | 否 | 是否应用带宽弹性伸缩功能配置项Bandwidth下的配置:
| true |
Upgrade | boolean | 否 | 是否开启带宽自动扩展:
| true |
BandwidthUsageUpperThreshold | integer | 否 | 触发带宽自动扩展的带宽平均使用率阈值,单位为%,取值:
| 70 |
ObservationWindowSize | string | 否 | 带宽自动扩展的观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:
| 5m |
Downgrade | boolean | 否 | 是否开启带宽自动回缩:
| true |
BandwidthUsageLowerThreshold | integer | 否 | 触发带宽自动回缩的带宽平均使用率阈值,单位为%,取值:
| 30 |
Shard | object | 否 | 分片弹性伸缩功能配置项。 | |
Apply | boolean | 否 | 是否应用分片弹性伸缩功能配置项Shard下的配置:
注意仅当目标数据库实例为中国站Redis云盘社区版集群架构时,支持分片弹性伸缩功能。
| true |
Upgrade | boolean | 否 | 是否开启自动增加分片:
| true |
MemUsageUpperThreshold | integer | 否 | 触发自动增加分片的内存平均利用率阈值,单位为%,取值:
| 70 |
MaxShards | integer | 否 | 实例总分片数的最大值, 取值为正整数,取值范围:4~32。 | 16 |
UpgradeObservationWindowSize | string | 否 | 自动增加分片观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:
| 5m |
Downgrade | boolean | 否 | 自动减少分片是否开启:
说明自动减少分片功能目前在灰度发布中。 | true |
MemUsageLowerThreshold | integer | 否 | 触发自动减少分片的内存平均利用率阈值,单位为%,取值:
| 30 |
MinShards | integer | 否 | 实例总分片数的最小值,取值为正整数,取值范围:4~32。 | 4 |
DowngradeObservationWindowSize | string | 否 | 自动减少分片观测窗口,参数由数值和时间单位后缀组成,其中时间单位后缀h表示小时,d表示天:
| 1h |
Resource | object | 否 | 资源弹性伸缩功能配置项。 | |
Apply | boolean | 否 | 是否应用资源弹性伸缩功能配置项Resource下的配置:
| true |
Enable | boolean | 否 | 是否开启资源弹性伸缩:
| true |
CpuUsageUpperThreshold | integer | 否 | 触发资源自动扩容的CPU平均利用率阈值,单位为%,取值:
| 70 |
UpgradeObservationWindowSize | string | 否 | 扩容观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:
| 5m |
DowngradeObservationWindowSize | string | 否 | 缩容观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:
| 5m |
返回参数
示例
正常返回示例
JSON
格式
{
"Code": "200",
"Message": "Successful",
"RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Success": "true"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
访问错误中心查看更多错误码。