首页 数据库自治服务 DAS API参考指南 API目录 自动弹性伸缩 ModifyAutoScalingConfig - 修改实例弹性伸缩功能配置

ModifyAutoScalingConfig - 修改实例弹性伸缩功能配置

调用ModifyAutoScalingConfig接口,修改实例弹性伸缩功能配置。

接口说明

API支持修改数据库实例的规格弹性伸缩功能、存储自动扩容功能、带宽弹性伸缩功能、分片弹性伸缩功能以及资源弹性伸缩功能:

  • 以下目标数据库实例支持修改规格弹性伸缩功能:

  • 以下目标数据库实例支持修改存储自动扩容功能:

  • 以下目标数据库实例支持修改带宽弹性伸缩功能:

  • 以下目标数据库实例支持修改分片弹性伸缩功能:

  • 以下目标数据库实例支持修改资源弹性伸缩功能:

    • RDS MySQL高可用本地盘版(通用型)和三节点企业版(通用型),功能介绍及费用说明参见自动性能扩展
  • 使用阿里云或DAS的SDK时,建议使用最新版本。

  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
hdm:ModifyAutoScalingConfigWrite
  • DAS
    acs:hdm:*:{#accountId}:*

请求参数

名称类型必填描述示例值
InstanceIdstring

实例ID。

rm-2ze8g2am97624****
Specobject

规格弹性伸缩功能配置项。

Applyboolean

是否应用规格弹性伸缩功能配置项Spec下的配置:

  • true:是。
  • false:否。
true
Upgradeboolean

是否开启规格自动扩容:

  • true:是。
  • false:否。
true
CpuUsageUpperThresholdinteger

触发规格自动扩容的CPU平均利用率阈值,单位为%,取值:

  • 50
  • 60
  • 70
  • 80
  • 90
注意目标数据库实例为PolarDB MySQL集群版、RDS MySQL高可用云盘版时,需要设置本参数。
70
MemUsageUpperThresholdinteger

触发规格自动扩容的内存平均利用率阈值,单位为%,取值:

  • 50
  • 60
  • 70
  • 80
  • 90
注意目标数据库实例为中国站Redis社区云盘版时,需要设置本参数。
70
MaxSpecstring

自动扩容的规格上限。详情请参见各数据库实例的产品规格文档:

polar.mysql.x8.12xlarge
MaxReadOnlyNodesinteger

实例只读节点数的最大值。

注意目标数据库实例为PolarDB MySQL集群版时,需要设置本参数。
10
ObservationWindowSizestring

观测窗口。参数值由数值和时间单位后缀组成,支持的数据库实例及其取值如下,其中时间后缀m表示分钟,h表示小时:

  • PolarDB MySQL集群版:5m10m15m30m
  • RDS MySQL高可用云盘版:5m20m30m40m1h
  • Redis社区云盘版:5m10m15m30m
5m
CoolDownTimestring

静默期。参数值由数值和时间单位后缀组成,支持的数据库实例及其取值如下,其中时间单位后缀m表示分钟,h表示小时,d:表示天:

  • PolarDB MySQL集群版:5m10m30m1h2h3h1d7d
  • RDS MySQL高可用云盘版:5m10m30m1h2h3h1d7d
5m
Downgradeboolean

是否开启规格自动回缩:

  • true:是。
  • false:否。
注意目标数据库实例为PolarDB MySQL集群版、RDS MySQL高可用云盘版时,需要设置本参数。
true
Storageobject

存储自动扩容功能配置项。

Applyboolean

是否应用存储自动扩容功能配置项Storage下的配置:

  • true:是。
  • false:否。
true
Upgradeboolean

是否开启存储自动扩容:

  • true:是。
  • false:否。
true
DiskUsageUpperThresholdinteger

触发存储自动扩容的存储空间平均利用率阈值,单位为%,取值:

  • 50
  • 60
  • 70
  • 80
  • 90
70
MaxStorageinteger

存储空间上限,需要大于等于实例当前存储空间总大小,取值:

  • ESSD云盘上限:32000 GB。
  • SSD云盘上限:6000 GB。
说明SSD云盘已下线,建议升级至ESSD云盘
32000
Bandwidthobject

带宽弹性伸缩功能配置项。

Applyboolean

是否应用带宽弹性伸缩功能配置项Bandwidth下的配置:

  • true:是。
  • false:否。
true
Upgradeboolean

是否开启带宽自动扩展:

  • true:是。
  • false:否。
true
BandwidthUsageUpperThresholdinteger

触发带宽自动扩展的带宽平均使用率阈值,单位为%,取值:

  • 50
  • 60
  • 70
  • 80
  • 90
  • 95
70
ObservationWindowSizestring

带宽自动扩展的观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:

  • 1m
  • 5m
  • 10m
  • 15m
  • 30m
5m
Downgradeboolean

是否开启带宽自动回缩:

  • true:是。
  • false:否。
true
BandwidthUsageLowerThresholdinteger

触发带宽自动回缩的带宽平均使用率阈值,单位为%,取值:

  • 10
  • 20
  • 30
30
Shardobject

分片弹性伸缩功能配置项。

Applyboolean

是否应用分片弹性伸缩功能配置项Shard下的配置:

  • true:是。
  • false:否。
注意仅当目标数据库实例为中国站Redis云盘社区版集群架构时,支持分片弹性伸缩功能。
true
Upgradeboolean

是否开启自动增加分片:

  • true:是。
  • false:否。
true
MemUsageUpperThresholdinteger

触发自动增加分片的内存平均利用率阈值,单位为%,取值:

  • 50
  • 60
  • 70
  • 80
  • 90
70
MaxShardsinteger

实例总分片数的最大值, 取值为正整数,取值范围:4~32。

16
UpgradeObservationWindowSizestring

自动增加分片观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:

  • 5m
  • 10m
  • 15m
  • 30m
5m
Downgradeboolean

自动减少分片是否开启:

  • true:是。
  • false:否。
说明自动减少分片功能目前在灰度发布中。
true
MemUsageLowerThresholdinteger

触发自动减少分片的内存平均利用率阈值,单位为%,取值:

  • 10
  • 20
  • 30
30
MinShardsinteger

实例总分片数的最小值,取值为正整数,取值范围:4~32。

4
DowngradeObservationWindowSizestring

自动减少分片观测窗口,参数由数值和时间单位后缀组成,其中时间单位后缀h表示小时,d表示天:

  • 1h
  • 2h
  • 3h
  • 1d
  • 7d
1h
Resourceobject

资源弹性伸缩功能配置项。

Applyboolean

是否应用资源弹性伸缩功能配置项Resource下的配置:

  • true:是。
  • false:否。
true
Enableboolean

是否开启资源弹性伸缩:

  • true:是。
  • false:否。
true
CpuUsageUpperThresholdinteger

触发资源自动扩容的CPU平均利用率阈值,单位为%,取值:

  • 70
  • 80
  • 90
70
UpgradeObservationWindowSizestring

扩容观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:

  • 1m
  • 3m
  • 5m
  • 10m
  • 20m
  • 30m
5m
DowngradeObservationWindowSizestring

缩容观测窗口。参数值由数值和时间单位后缀组成,其中时间单位后缀m表示分钟:

  • 1m
  • 3m
  • 5m
  • 10m
  • 20m
  • 30m
5m

返回参数

名称类型描述示例值
object
Codestring

返回的状态码。

200
Messagestring

请求返回消息。

说明请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
Successful
RequestIdstring

请求ID。

B6D17591-B48B-4D31-9CD6-9B9796B2****
Successstring

请求是否执行成功:

  • true:执行成功。

  • false:执行失败。

true

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe request parameters are invalid.请求参数错误

访问错误中心查看更多错误码。

阿里云首页 数据库自治服务 相关技术圈