VM::EC2::Instance::Status::Event3pm

Usage

 @status_items = $ec2->describe_instance_status();
 for my $i (@status_items) {
    for my $event ($i->events) {
       print $i->instance_id,': ',
             $event->code,' ',
             $event->description, ' ',
             $event->notBefore, ' ',
             $event->notAfter,"\n";
    }
 }

Overview

This objects describes a scheduled maintenance event on an instance, and is returned by calling the events() method of one of the status item objects returned by $ec2->describe_instance_status().

NOTE: There is an inconsistency in the AWS documentation for this data type. The events field is documented as being a list, but the examples shown show a single object. At release time, I was unable to verify which is correct and have written the code such that it will detect a single value in the response object and return this as a single-element list.

Methods

 code()        -- The code for this event, one of "instance-reboot", 
                    "system-reboot", "instance-retirement"
 description() -- A description of the event.
 notBefore()   -- The earliest scheduled start time for the event.
 notAfter()    -- The latest scheduled end time for the event.

When used in a string context, this object interpolates as a string in the form:

 system-reboot [2011-12-05T13:00:00+0000 - 2011-12-06T13:00:00+000]