VM::EC...:Event(3pm)

💅 VM::EC2::Volume::Status::Event — the whole vibe

okay so this is a page from the User Contributed Perl Documentation set, and it's all about VM::EC2::Volume::Status::Event, bestie. It's a Perl module, it lives in the VM::EC2 family, and it's the little object that tells you about a scheduled maintenance event on a volume. Let's get into it 🫶

---

✨ NAME ✨

VM::EC2::Volume::Status::Event — an object that describes a scheduled volume maintenance event. literally what it says on the tin 💖

---

🦋 SYNOPSIS 🦋

here's the serve. you grab your status items, then for each one you loop through its events and print the deets:

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

look at that. $i->volume_id, then the event's type, description, notBefore and notAfter, all separated by spaces and finished with a newline. clean. no notes. ✨

---

🌸 DESCRIPTION 🌸

So. This object describes a scheduled maintenance event on a volume, and you get one of these by calling the events() method on one of the status item objects that $ec2->describe_volume_status() hands back. that's the pipeline, bestie 🎀

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 that are shown show a single object. At release time, the author was unable to verify which one is correct, and so the code was written such that it will detect a single value in the response object and return this as a single-element list. so either way you're covered, but like… AWS pls. get it together. 💀

---

👑 METHODS 👑

here's the whole roster, no skips:

• eventType — the type of the event.
• eventId — the ID of the event.
• description — a description of the event.
• notBefore — the earliest scheduled start time for the event.
• notAfter — the latest scheduled end time for the event.
• type — alias for eventType.
• id — alias for eventId.

and one more lil thing: when this object is used in a string context, it interpolates as a string using the eventType. so it knows how to introduce itself 💅

---

🌈 SEE ALSO 🌈

go read these too, they're the friend group:

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Volume
• VM::EC2::Volume::Status
• VM::EC2::Volume::StatusItem
• VM::EC2::Volume::Status::Details
• VM::EC2::Tag

---

💜 AUTHOR 💜

Lincoln Stein <lincoln.stein@gmail.com>. icon behavior, fr fr.

Copyright (c) 2012 Ontario Institute for Cancer Research.

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty. 🫶

---

and that's the whole page, bestie!! this was rendered by perl v5.38.2 on 2024-08-10 — so if you're reading this in the future, hi, hope the volumes are healthy 💖✨🦋