
describe-events
***************


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 Iinstance, DB security group, DB Snapshot,
or DB parameter group can be obtained by providing the source
identifier as a parameter. By default, the past hour of events are
returned.

You can see a list of event categories and source types in the Events
topic in the Amazon RDS User Guide.


SYNOPSIS
========

   aws rds describe-events
     [--event-categories <value>]
     [--source-type <value>]
     [--marker <value>]
     [--max-records <value>]
     [--start-time <value>]
     [--duration <value>]
     [--source-identifier <value>]
     [--end-time <value>]


REQUIRED PARAMETERS
===================

None


OPTIONAL PARAMETERS
===================

"--event-categories"  (list of string)
   A list of event categories that trigger notifications for a event
   notification subscription.

   *Parameter Syntax*

      ["string", ...]

"--source-type"  (string)
   The event source to retrieve events for. If no value is specified,
   all events are returned.

"--marker"  (string)
   An optional pagination token provided by a previous describe-events
   request. If this parameter is specified, the response includes only
   records beyond the marker, up to the value specified by "--max-
   records" .

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

   Default: 100

   Constraints: minimum 20, maximum 100

"--start-time"  (timestamp)
   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

"--duration"  (integer)
   The number of minutes to retrieve events for.

   Default: 60

"--source-identifier"  (string)
   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 --source-identifier is supplied, --source-type 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.

"--end-time"  (timestamp)
   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
