DescribeEvents - Amazon Relational Database Service

Description

Returns events related to DB Instances, DB Security Groups, DB Snapshots and DB Parameter Groups for the past 14 days. Events specific to a particular DB Instance, DB Security Group, database snapshot or DB Parameter Group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name	Description	Required
`Duration`	The number of minutes to retrieve events for. Default: 60 Type: Integer	No
`EndTime`	The end of the time interval for which to retrieve events, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page. Example: 2009-07-08T18:00Z Type: DateTime	No
`Marker`	An optional marker provided in the previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by `MaxRecords`. Type: String	No
`MaxRecords`	The maximum number of records to include in the response. If more records exist than the specified `MaxRecords` value, a marker is included in the response so that the remaining results may be retrieved. Default: 100 Constraints: minimum 20, maximum 100 Type: Integer	No
`SourceIdentifier`	The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response. Constraints: If SourceIdentifier is supplied, SourceType must also be provided. If the source type is DBInstance, then a DBInstanceIdentifier must be supplied. If the source type is DBSecurityGroup, a DBSecurityGroupName must be supplied. If the source type is DBParameterGroup, a DBParameterGroupName must be supplied. If the source type is DBSnapshot, a DBSnapshotIdentifier must be supplied. Cannot end with a hyphen or contain two consecutive hyphens. Type: String	No
`SourceType`	The event source to retrieve events for. If no value is specified, all events are returned. Type: String Valid Values: `db-instance \| db-parameter-group \| db-security-group \| db-snapshot`	No
`StartTime`	The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page. Example: 2009-07-08T18:00Z Type: DateTime	No

Response Elements

The following elements come wrapped in a DescribeEventsResult structure.

Name Description

Name	Description
`Events`	A list of Event instances. Type: Event list
`Marker`	The marker obtained from a previous operation response. Type: String

Events

A list of Event instances.

Type: Event list

Marker

The marker obtained from a previous operation response.

Type: String

Examples

Sample Request

https://rds.amazonaws.com/
    ?Action=DescribeEvents
    &Duration=1440
    &MaxRecords=100
    &Version=2012-04-23
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2011-02-15T20%3A00%3A44.420Z
    &AWSAccessKeyId=<AWS Access Key ID>
    &Signature=<Signature>

Sample Response

<DescribeEventsResponse xmlns="http://rds.amazonaws.com/doc/2012-04-23/">
  <DescribeEventsResult>
    <Events>
      <Event>
        <Message>Applied change to security group</Message>
        <SourceType>db-security-group</SourceType>
        <Date>2010-08-11T17:12:52.860Z</Date>
        <SourceIdentifier>mydbsecuritygroup</SourceIdentifier>
      </Event>
      <Event>
        <Message>Database instance created</Message>
        <SourceType>db-instance</SourceType>
        <Date>2010-08-11T18:10:15.269Z</Date>
        <SourceIdentifier>mydbinstance3</SourceIdentifier>
      </Event>
      <Event>
        <Message>Backing up database instance</Message>
        <SourceType>db-instance</SourceType>
        <Date>2010-08-11T18:10:34.690Z</Date>
        <SourceIdentifier>mydbinstance3</SourceIdentifier>
      </Event>
      <Event>
        <Message>Backing up DB Instance</Message>
        <SourceType>db-instance</SourceType>
        <Date>2010-08-11T18:25:52.263Z</Date>
        <SourceIdentifier>mynewdbinstance</SourceIdentifier>
      </Event>
      <Event>
        <Message>Creating user snapshot</Message>
        <SourceType>db-snapshot</SourceType>
        <Date>2010-08-11T18:25:52.263Z</Date>
        <SourceIdentifier>mynewdbsnapshot3</SourceIdentifier>
      </Event>
    </Events>
  </DescribeEventsResult>
  <ResponseMetadata>
    <RequestId>95b948cd-bf45-11de-86a4-97241dfaadff</RequestId>
  </ResponseMetadata>
</DescribeEventsResponse>