GET

/#Action=DescribeEvents

http://rds.{region}.amazonaws.com/#Action=DescribeEvents

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.

Access Token Required: API Key

Query Params

SourceIdentifierstring

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response. Constraints: <ul> <li> If SourceIdentifier is supplied, SourceType must also be provided. </li> <li> If the source type is <code>DBInstance</code>, then a <code>DBInstanceIdentifier</code> must be supplied. </li> <li> If the source type is <code>DBSecurityGroup</code>, a <code>DBSecurityGroupName</code> must be supplied. </li> <li> If the source type is <code>DBParameterGroup</code>, a <code>DBParameterGroupName</code> must be supplied. </li> <li> If the source type is <code>DBSnapshot</code>, a <code>DBSnapshotIdentifier</code> must be supplied. </li> <li> Cannot end with a hyphen or contain two consecutive hyphens. </li> </ul>

SourceTypestring

The event source to retrieve events for. If no value is specified, all events are returned.

Allowed:

StartTimestring

The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the <a href="http://en.wikipedia.org/wiki/ISO_8601">ISO8601 Wikipedia page.</a> Example: 2009-07-08T18:00Z

EndTimestring

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 <a href="http://en.wikipedia.org/wiki/ISO_8601">ISO8601 Wikipedia page.</a> Example: 2009-07-08T18:00Z

Durationinteger

The number of minutes to retrieve events for. Default: 60

EventCategoriesarray

A list of event categories that trigger notifications for a event notification subscription.

Filtersarray

This parameter is not currently supported.

MaxRecordsinteger

The maximum number of records to include in the response. If more records exist than the specified <code>MaxRecords</code> value, a pagination token called a marker is included in the response so that the remaining results can be retrieved. Default: 100 Constraints: Minimum 20, maximum 100.

Markerstring

An optional pagination token provided by a previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by <code>MaxRecords</code>.

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://rds.{region}.amazonaws.com/#Action=DescribeEvents' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}