Skip to content

/AWS1/CL_DOD=>DESCRIBEEVENTS()

About DescribeEvents

Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days. You can obtain events specific to a particular DB instance, security group, snapshot, or parameter group by providing the name as a parameter. By default, the events of the past hour are returned.

Method Signature

IMPORTING

Optional arguments:

IV_SOURCEIDENTIFIER TYPE /AWS1/DODSTRING /AWS1/DODSTRING

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response.

Constraints:

  • If SourceIdentifier is provided, SourceType must also be provided.

  • If the source type is DBInstance, a DBInstanceIdentifier must be provided.

  • If the source type is DBSecurityGroup, a DBSecurityGroupName must be provided.

  • If the source type is DBParameterGroup, a DBParameterGroupName must be provided.

  • If the source type is DBSnapshot, a DBSnapshotIdentifier must be provided.

  • Cannot end with a hyphen or contain two consecutive hyphens.

IV_SOURCETYPE TYPE /AWS1/DODSOURCETYPE /AWS1/DODSOURCETYPE

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

IV_STARTTIME TYPE /AWS1/DODTSTAMP /AWS1/DODTSTAMP

The beginning of the time interval to retrieve events for, specified in ISO 8601 format.

Example: 2009-07-08T18:00Z

IV_ENDTIME TYPE /AWS1/DODTSTAMP /AWS1/DODTSTAMP

The end of the time interval for which to retrieve events, specified in ISO 8601 format.

Example: 2009-07-08T18:00Z

IV_DURATION TYPE /AWS1/DODINTEGEROPTIONAL /AWS1/DODINTEGEROPTIONAL

The number of minutes to retrieve events for.

Default: 60

IT_EVENTCATEGORIES TYPE /AWS1/CL_DODEVENTCATSLIST_W=>TT_EVENTCATEGORIESLIST TT_EVENTCATEGORIESLIST

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

IT_FILTERS TYPE /AWS1/CL_DODFILTER=>TT_FILTERLIST TT_FILTERLIST

This parameter is not currently supported.

IV_MAXRECORDS TYPE /AWS1/DODINTEGEROPTIONAL /AWS1/DODINTEGEROPTIONAL

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token (marker) is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

IV_MARKER TYPE /AWS1/DODSTRING /AWS1/DODSTRING

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

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_DODEVENTSMESSAGE /AWS1/CL_DODEVENTSMESSAGE