Call the DescribeAutoScaleEvents API to query scaling events for a specified instance.

Request type

Synchronous request

Request parameters

Parameter	Type	Is it required?	Sample	Description
InstanceType	String	Yes	Postgres	Database type. Currently, only the value Postgres is supported, indicating RDS for PostgreSQL.
InstanceId	String	Yes	postgres-5d1******	Instance ID. tip You can call the DescribeDBInstances API to query the instance IDs of all RDS for PostgreSQL instances in the target region.
RegionId	String	Yes	cn-guangzhou	Region ID.
Metric	String	Yes	Disk	Scaling indicator. Currently, only disk scaling out is supported, meaning this parameter takes the value Disk.
autoScaleSearchParam	AutoScaleSearchParam	No	{ "StartTime": 1787638268, "EndTime": 1787640068 }	Event filter criteria.
PageNumber	Integer	No	1	Page number. The value range is 1 to 1,000, with a default of 1.
PageSize	Integer	No	10	Number of records per page. The value range is 1 to 1,000, with a default of 10.

Response parameters

Name	Type	Sample	Description
Total	Integer	10	Total number of scaling events.
AutoScaleEvents	Array of AutoScaleEvent	[ { "Action": "Expand", "After": "0G", "AfterAutoScale": 0, "AutoScaleMetricName": "Disk", "Before": "300G", "BeforeAutoScale": 0, "EndTime": "2026-08-25T06:30:44Z", "EventId": "2092137580354129920", "EventStatus": "EventScaling", "Memo": "", "MetricUnit": "%", "RuleId": "2031045967368716288", "RuleType": "Auto", "StartTime": "2026-08-25T06:30:44Z", "TriggerCondition": [ { "ComparisonOperator": "\u003e", "MetricName": "磁盘使用率", "Threshold": "90.00%", "TimeInfo": "" } ], "TriggerInfo": "", "TriggerValue": "100.26%" } ]	Scaling event list.

Request example

POST /?Action=DescribeAutoScaleEvents&Version=2018-01-01 HTTP/1.1​
Content-Type: application/json​
Host: dbw.cn-beijing.volcengineapi.com​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/dbw/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
​
{​
    "InstanceType": "Postgres",​
    "PageSize": 10,​
    "PageNumber": 1,​
    "RegionId": "cn-beijing",​
    "Metric": "ALL",​
    "InstanceId": "postgres-e6a7239edcab",​
    "AutoScaleSearchParam": {​
        "StartTime": 1787638268,​
        "EndTime": 1787640068​
    }​
}​

Response example

{​
    "ResponseMetadata": {​
        "RequestId": "20260825144108880EAD48C32456E4DA8C-e74a6d",​
        "Action": "DescribeAutoScaleEvents",​
        "Version": "2018-01-01",​
        "Service": "dbw",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "AutoScaleEvents": [​
            {​
                "Action": "Expand",​
                "After": "0G",​
                "AfterAutoScale": 0,​
                "AutoScaleMetricName": "Disk",​
                "Before": "300G",​
                "BeforeAutoScale": 0,​
                "EndTime": "2026-08-25T06:30:44Z",​
                "EventId": "2092137580354129920",​
                "EventStatus": "EventScaling",​
                "Memo": "",​
                "MetricUnit": "%",​
                "RuleId": "2031045967368716288",​
                "RuleType": "Auto",​
                "StartTime": "2026-08-25T06:30:44Z",​
                "TriggerCondition": [​
                    {​
                        "ComparisonOperator": "\u003e",​
                        "MetricName": "磁盘使用率",​
                        "Threshold": "90.00%",​
                        "TimeInfo": ""​
                    }​
                ],​
                "TriggerInfo": "",​
                "TriggerValue": "100.26%"​
            }​
        ],​
        "Total": 1​
    }​
}​

Error code

For details, refer to Error codes.

Database Workshop