调用DescribeEvents接口查询RDS历史事件记录列表。

RDS提供历史事件功能,开启后您可以在所处地域内查看某时间段的历史事件,例如在某个时间创建了实例、修改了参数等等。详情请参见历史事件

调用该接口时,实例必须已开启历史事件功能,否则将操作失败。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeEvents

系统规定参数。取值:DescribeEvents

RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看地域ID。

StartTime String 2019-06-11T15:00:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

EndTime String 2019-06-12T15:00:00Z

查询结束时间,需要晚于开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

PageSize Integer 30

每页记录数,取值:

  • 30
  • 50
  • 100

默认值:30

PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。

默认值:1

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

页码。

RequestId String A103039D-B1B2-4C57-B989-7D7C0DA95426

请求ID。

PageSize Integer 30

每页记录数。

TotalRecordCount Integer 40

总记录数。

EventItems Array of EventItems

事件列表。

EventItems
EventName String ModifySecurityIPList

事件名称。详情请参见历史事件

EventTime String 2019-08-20T01:08:22Z

事件发生时间。

EventUserType String SYSTEM

执行事件的用户类型。

EventRecordTime String 2019-08-20T01:12:49Z

事件的记录时间。会稍晚于事件的发生时间。

CallerUid Long 22973492**********

事件执行人的用户ID。

RegionId String cn-hangzhou

地域ID。

EventId Integer 11000053

事件ID。

EventType String NetworkManagement

事件类型。详情请参见历史事件

ResourceType String instance

事件关联资源类型。当前仅有实例。

EventPayload String {\"Domain\": \"rds-inc-share.aliyuncs.com\", \"Api\": \"ReleaseInstancePublicConnection\"}

事件的请求参数或上下文参数。

EventReason String FROM_USER

事件操作的来源。详情请参见历史事件

ResourceName String rm-bp1z3065m9976ix8a

事件关联资源名称。当前仅有实例ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeEvents
&Region=cn-hangzhou
&StartTime=2019-08-20T01:30:00Z
&EndTime=2019-08-20T01:35:00Z
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeEventsResponse>
    <EventItems>
        <EventItems>
            <EventName>ModifySecurityIPList</EventName>
            <EventUserType>SYSTEM</EventUserType>
            <ResourceType>instance</ResourceType>
            <EventPayload/>
            <EventTime>2019-08-20T01:33:43Z</EventTime>
            <RegionId>cn-hangzhou</RegionId>
            <EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
            <EventReason>FROM_SYSTEM</EventReason>
            <EventId>11000048</EventId>
            <ResourceName>rm-bpxxxxxxx</ResourceName>
            <EventType>SecurityManagement</EventType>
            <CallerUid>25421491**********</CallerUid>
        </EventItems>
        <EventItems>
            <EventName>ModifySecurityIPList</EventName>
            <EventUserType>SYSTEM</EventUserType>
            <ResourceType>instance</ResourceType>
            <EventPayload/>
            <EventTime>2019-08-20T01:33:43Z</EventTime>
            <RegionId>cn-hangzhou</RegionId>
            <EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
            <EventReason>FROM_SYSTEM</EventReason>
            <EventId>11000047</EventId>
            <ResourceName>rm-bpxxxxxxx</ResourceName>
            <EventType>SecurityManagement</EventType>
            <CallerUid>22973492**********</CallerUid>
        </EventItems>
    </EventItems>
    <TotalRecordCount>2</TotalRecordCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <RequestId>B5FF9EE6-830E-4DBE-8498-9890A62D2875</RequestId>
</DescribeEventsResponse>

JSON格式

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

{
  "EventItems" : {
    "EventItems" : [ {
      "EventName" : "ModifySecurityIPList",
      "EventUserType" : "SYSTEM",
      "ResourceType" : "instance",
      "EventPayload" : "",
      "EventTime" : "2019-08-20T01:33:43Z",
      "RegionId" : "cn-hangzhou",
      "EventRecordTime" : "2019-08-20T01:33:57Z",
      "EventReason" : "FROM_SYSTEM",
      "EventId" : 11000048,
      "ResourceName" : "rm-bpxxxxxxx",
      "EventType" : "SecurityManagement",
      "CallerUid" : "25421491**********"
    }, {
      "EventName" : "ModifySecurityIPList",
      "EventUserType" : "SYSTEM",
      "ResourceType" : "instance",
      "EventPayload" : "",
      "EventTime" : "2019-08-20T01:33:43Z",
      "RegionId" : "cn-hangzhou",
      "EventRecordTime" : "2019-08-20T01:33:57Z",
      "EventReason" : "FROM_SYSTEM",
      "EventId" : 11000047,
      "ResourceName" : "rm-bpxxxxxxx",
      "EventType" : "SecurityManagement",
      "CallerUid" : "22973492**********"
    } ]
  },
  "TotalRecordCount" : 2,
  "PageNumber" : 1,
  "PageSize" : 2,
  "RequestId" : "B5FF9EE6-830E-4DBE-8498-9890A62D2875"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidStartTime.Format Specified start time is not valid. 指定的起始时间无效。
400 InvalidParameterCombination The end time must be greater than the start time 结束时间必须晚于开始时间。
400 RegionNotSupport The region is not supported. 操作失败,该地区不支持此操作。

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