DescribeAutoScalingHistory - 查询实例弹性伸缩历史信息 - 数据库自治服务 DAS

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

接口说明

当前仅支持查询 RDS MySQL 高可用系列云盘版的自动性能扩展历史信息。
使用阿里云或 DAS 的 SDK 时，建议使用最新版本。
在使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hdm:DescribeAutoScalingHistory

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。说明当前仅支持 RDS MySQL 实例。	rm-2ze8g2am97624****
AutoScalingTaskType	string	是	查询的弹性伸缩业务种类。当前仅支持 SPEC，表示仅支持查询自动性能扩展历史信息。	SPEC
StartTime	integer	是	查询任务的开始时间，格式为 Unix 时间戳，单位为毫秒。说明查询任务的开始时间最大不能早于当前时间 45 天。	1675833788056
EndTime	integer	是	查询任务结束时间，格式为 Unix 时间戳，单位为毫秒。说明查询任务结束时间需晚于查询任务开始时间。	1676605305796

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

返回参数

名称	类型	描述	示例值
	object
Code	string	状态码。200 表示成功。	200
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）。	Successful
RequestId	string	请求 ID。	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	请求是否执行成功： true：执行成功。 false：执行失败。	true
Data	object	弹性伸缩历史记录。
InstanceId	string	实例 ID。	rm-2ze1jdv45i7l6****
SpecHistory	array<object>	自动性能扩展历史记录。
	object	自动性能扩展历史信息。
ScaleType	string	自动性能扩展任务类型，取值： SCALE_UP：规格自动扩容。 SCALE_DOWN：规格自动缩容。	SCALE_UP
TaskExcuteStatus	boolean	任务执行状态： true：执行成功。 false：执行失败。	true
ErrorCode	string	扩缩容内部任务返回的错误码： Insufficient_Balance ：用户余额不足或存在未支付订单。 REACH_SPEC_UPPERBOUND ：已达到用户规格上限。 Control_Error_Timeout_Msg ：管控任务超时。 Invoke_Rds_Api_Error_Msg ：调用 RDS API 失败。	Insufficient_Balance
OriginInstanceClass	string	原始实例规格码。	mysql.n2.large.2c
TargetInstanceClass	string	目标实例规格码。	mysql.n2.xlarge.2c
OriginCore	integer	原始实例 CPU 核数。	4
OriginMemory	number	原始实例内存大小，单位 GB。	8
TargetCore	integer	目标实例 CPU 核数。	8
TargetMemory	number	目标实例内存大小，单位 GB。	16
TaskTime	integer	任务执行时间，格式为 Unix 时间戳，单位为毫秒。	1684830763000
Storage	array<object>	存储扩容历史记录，暂不支持。
	object	实例存储扩容历史信息。	None
Resource	array<object>	Redis 资源扩容历史记录，暂不支持。
	object	Redis 资源扩容历史信息。	None
Shard	array<object>	Redis 自动分片扩容历史记录，暂不支持。
	object	Redis 自动分片扩容历史信息。	None
Bandwidth	array<object>	Redis 带宽弹性伸缩历史记录，暂不支持。
	object	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	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

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

变更历史

更多信息，参考变更详情。