DescribeAutoScalingHistory - 查询实例弹性伸缩历史信息

调用DescribeAutoScalingHistory接口,查询实例弹性伸缩历史信息。

接口说明

  • 当前仅支持查询 RDS MySQL 高可用系列云盘版的自动性能扩展历史信息。

  • 使用阿里云或 DAS 的 SDK 时,建议使用最新版本。

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

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

实例 ID。

说明 当前仅支持 RDS MySQL 实例。
rm-2ze8g2am97624****
AutoScalingTaskTypestring

查询的弹性伸缩业务种类。当前仅支持 SPEC,表示仅支持查询自动性能扩展历史信息。

SPEC
StartTimelong

查询任务的开始时间,格式为 Unix 时间戳,单位为毫秒。

说明 查询任务的开始时间最大不能早于当前时间 45 天。
1675833788056
EndTimelong

查询任务结束时间,格式为 Unix 时间戳,单位为毫秒。

说明 查询任务结束时间需晚于查询任务开始时间。
1676605305796

AutoScalingTaskType 取值为 SPEC 时,表示查询自动性能扩展历史,当前仅支持取值为 SPEC。

返回参数

名称类型描述示例值
object
Codestring

状态码。200 表示成功。

200
Messagestring

请求返回消息。

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

请求 ID。

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

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。
true
Dataobject

弹性伸缩历史记录。

InstanceIdstring

实例 ID。

rm-2ze1jdv45i7l6****
SpecHistoryarray<object>

自动性能扩展历史记录。

SpecHistoryobject

自动性能扩展历史信息。

ScaleTypestring

自动性能扩展任务类型,取值:

  • SCALE_UP:规格自动扩容。
  • SCALE_DOWN:规格自动缩容。
SCALE_UP
TaskExcuteStatusboolean

任务执行状态:

  • true:执行成功。
  • false:执行失败。
true
ErrorCodestring

扩缩容内部任务返回的错误码:

  • Insufficient_Balance :用户余额不足或存在未支付订单。
  • REACH_SPEC_UPPERBOUND :已达到用户规格上限。
  • Control_Error_Timeout_Msg :管控任务超时。
  • Invoke_Rds_Api_Error_Msg :调用 RDS API 失败。
Insufficient_Balance
OriginInstanceClassstring

原始实例规格码。

mysql.n2.large.2c
TargetInstanceClassstring

目标实例规格码。

mysql.n2.xlarge.2c
OriginCoreinteger

原始实例 CPU 核数。

4
OriginMemorydouble

原始实例内存大小,单位 GB。

8
TargetCoreinteger

目标实例 CPU 核数。

8
TargetMemorydouble

目标实例内存大小,单位 GB。

16
TaskTimelong

任务执行时间,格式为 Unix 时间戳,单位为毫秒。

1684830763000
Storagearray<object>

存储扩容历史记录,暂不支持。

Storageobject

实例存储扩容历史信息。

None
Resourcearray<object>

Redis 资源扩容历史记录,暂不支持。

Resourceobject

Redis 资源扩容历史信息。

None
Shardarray<object>

Redis 自动分片扩容历史记录,暂不支持。

Shardobject

Redis 自动分片扩容历史信息。

None
Bandwidtharray<object>

Redis 带宽弹性伸缩历史记录,暂不支持。

Bandwidthobject

Redis 带宽弹性伸缩历史信息。

None

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "InstanceId": "rm-2ze1jdv45i7l6****",
    "SpecHistory": [
      {
        "ScaleType": "SCALE_UP",
        "TaskExcuteStatus": true,
        "ErrorCode": "Insufficient_Balance",
        "OriginInstanceClass": "mysql.n2.large.2c",
        "TargetInstanceClass": "mysql.n2.xlarge.2c",
        "OriginCore": 4,
        "OriginMemory": 8,
        "TargetCore": 8,
        "TargetMemory": 16,
        "TaskTime": 1684830763000
      }
    ],
    "Storage": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Resource": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Shard": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Bandwidth": [
      {
        "test": "test",
        "test2": 1
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe request parameters are invalid.请求参数错误
403NoPermissionYou are not authorized to do this action.没有权限执行该操作

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