Queries historical events.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeEvents

The operation that you want to perform. Set the value to DescribeEvents.

RegionId String Yes cn-hangzhou

The region ID of the instance.

StartTime String No 2021-10-18T03:07:25Z

The start time of the event. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

EndTime String No 2021-10-18T03:07:25Z

The end time of the event. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

PageSize Integer No 20

The number of events to return on each page.

PageNumber Integer No 1

The number of the page to return. Pages start from page 1.

Response parameters

Parameter Type Example Description
RequestId String 4748127A-6D50-432C-B635-433467074C27

The ID of the request.

TotalRecordCount Long 20

The total number of pages returned.

EventItems Array of EventItems

The array of event items.

EventId Long 50421290

The ID of the required event.

EventName String ModifySecurityIps

The list of one or more event names.

EventPayload String {\"Domain\": \"rds-cn-hangzhou.aliyuncs.com\"}

The supplementary information of the required event.

EventReason String FROM_USER

The reason for the required event.

EventRecordTime String 2021-10-15T06:39:49Z

The recorded time of the required event. The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mm:ssZ format. The time is displayed in UTC.

EventTime String 2021-10-15T06:35:00Z

The time when the event is executed. The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mm:ssZ format. The time is displayed in UTC.

EventType String SecurityManagement

The type of the event.

EventUserType String USRE

The user type of the event.

RegionId String cn-hangzhou

The region ID of the instance.

ResourceName String px-bp1v8udesc89g156g

The name of the resource.

ResourceType String instance

The type of the resource.

PageSize Long 20

The number of events returned on each page.

PageNumber Long 1

The page number of the returned page.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeEvents
&RegionId=cn-hangzhou
&StartTime=2021-10-18T03:07:25Z
&EndTime=2021-10-18T03:07:25Z
&PageSize=20
&PageNumber=1
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeEventsResponse>
    <RequestId>4748127A-6D50-432C-B635-433467074C27</RequestId>
    <TotalRecordCount>20</TotalRecordCount>
    <EventItems>
        <EventId>50421290</EventId>
        <EventName>ModifySecurityIps</EventName>
        <EventPayload>{\"Domain\": \"rds-cn-hangzhou.aliyuncs.com\"}</EventPayload>
        <EventReason>FROM_USER</EventReason>
        <EventRecordTime>2021-10-15T06:39:49Z</EventRecordTime>
        <EventTime>2021-10-15T06:35:00Z</EventTime>
        <EventType>SecurityManagement</EventType>
        <EventUserType>USRE</EventUserType>
        <RegionId>cn-hangzhou</RegionId>
        <ResourceName>px-bp1v8udesc89g156g</ResourceName>
        <ResourceType>instance</ResourceType>
    </EventItems>
    <PageSize>20</PageSize>
    <PageNumber>1</PageNumber>
</DescribeEventsResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4748127A-6D50-432C-B635-433467074C27",
  "TotalRecordCount" : 20,
  "EventItems" : [ {
    "EventId" : 50421290,
    "EventName" : "ModifySecurityIps",
    "EventPayload" : "{\\\"Domain\\\": \\\"rds-cn-hangzhou.aliyuncs.com\\\"}",
    "EventReason" : "FROM_USER",
    "EventRecordTime" : "2021-10-15T06:39:49Z",
    "EventTime" : "2021-10-15T06:35:00Z",
    "EventType" : "SecurityManagement",
    "EventUserType" : "USRE",
    "RegionId" : "cn-hangzhou",
    "ResourceName" : "px-bp1v8udesc89g156g",
    "ResourceType" : "instance"
  } ],
  "PageSize" : 20,
  "PageNumber" : 1
}

Error codes

For a list of error codes, visit the API Error Center.