DescribeHistoryEvents - - Alibaba Cloud Documentation Center

Lists the historical events in Event Center.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
PageSize	integer	No	The number of entries per page. Valid values: 30 50 100	10
PageNumber	integer	No	The page number to query. The default value is 1.	1
ArchiveStatus	string	No	The event status. Valid values: Archived: The event is archived. UnArchived: The event is not archived. All: All events.	All
EventCategory	string	No	The category of the system event. Valid values: Exception: anomalous activity Optimize: optimization events Notification: notification events Maintenance: scheduled O&M events	Exception
EventType	string	No	The type of the system event. This parameter is valid only when InstanceEventType.N is not specified. Valid values: SystemMaintenance.Reboot: The instance is restarted due to system maintenance. SystemMaintenance.Redeploy: The instance is redeployed due to system maintenance. SystemFailure.Reboot: The instance is restarted due to a system fault. SystemFailure.Redeploy: The instance is redeployed due to a system fault. SystemFailure.Delete: The instance is released because it failed to be created. InstanceFailure.Reboot: The instance is restarted due to an instance fault. InstanceExpiration.Stop: The subscription instance is stopped because its subscription expires. InstanceExpiration.Delete: The subscription instance is released because its subscription expires. AccountUnbalanced.Stop: The pay-as-you-go instance is stopped due to an overdue payment. AccountUnbalanced.Delete: The pay-as-you-go instance is released due to an overdue payment. Note The value of this parameter can only be an instance system event, not a disk system event.	SystemFailure.Reboot
EventLevel	string	No	The event level. Valid values are: INFO: Notification WARN: Warning CRITICAL: Critical	high
EventStatus	string	No	The event status. Valid values: Inquiring: The event is being inquired. Scheduled: The event is scheduled. Running: The event is in progress. Succeed: The event is successful. Failed: The event failed. Canceled: The event is canceled. Note To query multiple statuses, separate them with commas (,).	Succeed
ResourceType	string	No	The resource type. Valid values: Instance: instance resource Host: host resource User: user resource	Instance
InstanceId	string	No	The resource ID. Use this parameter to query tasks for a specific resource. To query tasks for multiple resources, separate the resource IDs with commas (,). You can specify up to 30 resource IDs. If you leave this parameter empty, all resources are queried. Note Currently, only cluster IDs are supported.	pc-2zed3m89cw***
EventId	string	No	The event ID.	5345398
TaskId	string	No	The ID of the scheduled task that you want to cancel. Note You can call the DescribeScheduleTasks operation to view information about all scheduled tasks under the current account, including task IDs. Only tasks that are pending execution (the `Status` parameter returns `pending`) can be canceled.	32077515
FromStartTime	string	No	The beginning of the time range to query tasks based on their start time. The tasks that started after this time are queried. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. You can query data from the last 30 days. If the specified time is more than 30 days ago, the system automatically sets it to 30 days ago.	2025-01-02T11:31:03Z
ToStartTime	string	No	The end of the time range to query tasks based on their start time. The tasks that started before this time are queried. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in `UTC`.	2025-01-03T12:31:03Z
ResourceGroupId	string	No	The resource group ID.	rg-**********
RegionId	string	No	The region ID.	cn-hangzhou

Response elements

Element	Type	Description	Example
	object	Schema of Response
PageNumber	integer	The page number of the returned page. The default value is 1.	1
RequestId	string	The request ID.	EB07CFF0-D8A4-5C76-AED7-D00E26FC2***
PageSize	integer	The number of entries returned per page. Valid values: 30 50 100	30
TotalCount	integer	The total number of entries in the list.	7
Items	array<object>	The list of events.
	array<object>	The list of events.
Id	string	The task ID.	123
Region	string	The ID of the region where the task is located.	cn-hangzhou
Source	string	The event source.	loanBill
Specversion	string	The database version.	8.0
Subject	string	The name of the pending event.	QiTian
Time	string	The runtime of the query task. Unit: seconds (s).	1758680209206
Type	string	The event type.	host
Data	object	The data overview.
EventType	string	The type of the system event. Valid values: SystemMaintenance.Reboot: The instance is restarted due to system maintenance. SystemMaintenance.Redeploy: The instance is redeployed due to system maintenance. SystemFailure.Reboot: The instance is restarted due to a system fault. SystemFailure.Redeploy: The instance is redeployed due to a system fault. SystemFailure.Delete: The instance is released because it failed to be created. InstanceFailure.Reboot: The instance is restarted due to an instance fault. InstanceExpiration.Stop: The subscription instance is stopped because its subscription expires. InstanceExpiration.Delete: The subscription instance is released because its subscription expires. AccountUnbalanced.Stop: The pay-as-you-go instance is stopped due to an overdue payment. AccountUnbalanced.Delete: The pay-as-you-go instance is released due to an overdue payment.	SystemFailure.Delete
EventId	string	The event ID.	600324
CmsProduct	string	The type of the Alibaba Cloud service for the application group. Valid values: web: web application. native: native application.	web
DbType	string	The database type.	mysql
DetailImpact	string	This parameter is used for pagination.	1
DetailReason	string	The details of the instance operation.	xxxx
EndTime	string	The end of the query time range. The end time must be later than the start time. The interval between the start time and the end time must be within 24 hours. The time is in the `YYYY-MM-DDThh:mmZ` format and is displayed in UTC.	2025-12-24T02:24:00Z
EventCategory	string	The category of the system event. Valid values: Exception: anomalous activity Optimize: optimization events Notification: notification events Maintenance: scheduled O&M events	Exception
EventCode	string	The event code.	de_aamexg3015
EventDetail	string	The event details.	xxxx
EventImpact	string	An overview of the event's impact.	xxxx
EventLevel	string	The event level. Valid values: INFO: notification WARN: warning CRITICAL: urgent	INFO
EventReason	string	The source of the event operation.	xxxxx
EventStatus	string	The event status. Valid values: Inquiring: The event is being inquired. Scheduled: The event is scheduled. Running: The event is in progress. Succeed: The event is successful. Failed: The event failed. Canceled: The event is canceled.	Inquiring
GmtCreated	string	The creation time.	2025-07-15T14:53:06+08:00
GmtModified	string	The update time.	2025-01-07T15:10:32+08:00
HandleStatus	string	The processing status.	done
HasLifeCycle	integer	Indicates whether a lifecycle exists.	false
InstanceId	string	The instance ID.	pc-2ze150h1p29t***
InstanceName	string	The instance name.	dhimgsearch
IsClosed	integer	Indicates whether the event is successfully closed. Valid values: 0: closed 1: open	1
Product	string	The product name.	polardb
RegionId	string	The region ID.	cn-beijing
ResourceType	string	The resource type. Valid values: Instance: instance resource Host: host resource User: user resource	Host
SourceType	string	The type of the source data.	loanBill
StartTime	string	The start of the query time range. The time is in the `yyyy-MM-ddTHH:mm:ssZ` format and is displayed in UTC.	2025-02-27T02:00:00Z
Uid	string	The ID of the user to whom the resource belongs.	1540497309282125

Examples

Success response

JSON format

{
  "PageNumber": 1,
  "RequestId": "EB07CFF0-D8A4-5C76-AED7-D00E26FC2***",
  "PageSize": 30,
  "TotalCount": 7,
  "Items": [
    {
      "Id": "123",
      "Region": "cn-hangzhou",
      "Source": "loanBill",
      "Specversion": "8.0",
      "Subject": "QiTian",
      "Time": "1758680209206",
      "Type": "host",
      "Data": {
        "EventType": "SystemFailure.Delete",
        "EventId": "600324",
        "CmsProduct": "web",
        "DbType": "mysql",
        "DetailImpact": "1",
        "DetailReason": "xxxx",
        "EndTime": "2025-12-24T02:24:00Z",
        "EventCategory": "Exception",
        "EventCode": "de_aamexg3015",
        "EventDetail": "xxxx",
        "EventImpact": "xxxx",
        "EventLevel": "INFO",
        "EventReason": "xxxxx",
        "EventStatus": "Inquiring",
        "GmtCreated": "2025-07-15T14:53:06+08:00",
        "GmtModified": "2025-01-07T15:10:32+08:00",
        "HandleStatus": "done",
        "HasLifeCycle": 0,
        "InstanceId": "pc-2ze150h1p29t***",
        "InstanceName": "dhimgsearch",
        "IsClosed": 1,
        "Product": "polardb",
        "RegionId": "cn-beijing",
        "ResourceType": "Host",
        "SourceType": "loanBill",
        "StartTime": "2025-02-27T02:00:00Z",
        "Uid": "1540497309282125"
      }
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.