rds-describe-events

Description

Returns information about events related to your DB Instances, DB Security Groups or DB Parameter Groups.

Syntax

rds-describe-events [--duration value ]

[--start-time value ] [--end-time value ] [--source-identifier value ] [--source-type value ] [--max-records value ] [General Options]

Options

Name	Description	Required
`--duration` `value`	The number of minutes for which to retrieve events. Type: Integer Default: 60 Example: Retrieve the last 90 minutes worth of events: `--duration 90`	No
`--start-time` `value`	The beginning of the time interval to retrieve events, specified in ISO8601 format. For more information about ISO 8601, go to the ISO8601 format Wikipedia page. Type: Date Default: none Example: `--start-time 2009-03-31T10:00:00`	No
`--end-time` `value`	The end of the time interval to retrieve events, specified in ISO8601 format. For more information about ISO 8601, go to the ISO8601 format Wikipedia page. Type: Date Default: none Example: `--start-time 2009-03-31T12:00:00`	No
`--source-type` `value`	Specifies the event source for which to retrieve events. Type: String Valid values: `db-instance`, `db-security-group`, `db-parameter-group`, `db-snapshot` Example: `--source-type db-instance`	No
`--source-identifier` `value`	Used with the `--source-type` parameter to restrict returned events to a specific named source. Type: String Default: 60 Example: `--source-type db-instance --source-identifier mydbinstance`	No

Output

The command returns the following information:

Source Type—Type of event source
Date—Database event date/time, in UTC
Source Id—Identifier of the event source
Message—Event description

Examples

Describe All Events

This example returns all events with column headers.

PROMPT> rds-describe-events --headers

    Source Type         Date                 Source Id       Message  
    db-instance         2009-03-27 00:28:44  test002         Database instance test002 deleted                                                         
    db-instance         2009-03-27 00:30:08  test003         Database instance test003 deleted                                                         
    db-instance         2009-03-27 00:37:59  test001         Database instance test001 created                                                         
    db-instance         2009-03-27 00:39:05  test0010        Database instance test0010 created                                                        
    db-security-group   2009-03-27 00:39:12  Default         Finished applying changes to security group                                                  
    db-security-group   2009-03-27 00:40:22  Default         The security group mysourcegroup owned by XXXXXX does not exist; revoking authorization
    db-security-group   2009-03-27 00:44:44  Default         Finished applying changes to security group                                                  
    db-instance         2009-03-27 01:07:53  test0010        Database instance test0010 deleted                                                        
    db-instance         2009-03-27 01:09:09  test02          Database instance test02 deleted                                                          
    db-instance         2009-03-27 01:09:22  test004         Database instance test004 deleted                                                         
    db-instance         2009-03-27 01:09:58  test001         Database instance test001 deleted        
    db-parameter-group  2009-03-27 00:39:12  myconfig        DBParameterGroup updated with parameter max_binlog_size to 4096 with apply method Immediate
    db-snapshot         2009-03-27 01:09:58  snapshotid      Deleted user snapshot: snapshotid

Describe Events for a Specified Instance

This example returns only events for a specific DB Instance.

PROMPT> rds-describe-events --source-type db-instance --source-identifier test001
                    
Source Type         Date                 Source Id       Message                                                       
db-instance         2009-03-27 00:37:59  test001         Database instance test001 created                                                         
db-instance         2009-03-27 01:09:58  test001         Database instance test001 deleted

Describe Events for a Specified Time Interval

This example returns only events for a specific time interval.

PROMPT> rds-describe-events --start-time 2009-03-20T00:00:00-08:00 --end-time 2009-03-20T23:59:59-08:00