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

💖 VM::EC2::Reservation 💖

okay bestie, gather round, because we're doing a manual page and it's giving "perl, but make it cute" 🎀

This one lives in the User Contributed Perl Documentation corner of your system, and the page itself is titled VM::EC...tionSet(3pm) (yes the name is truncated, no that's not a typo, the man page gods just have a character limit bestie 💀).

---

✨ NAME ✨

VM::EC2::Reservation — it's the object that describes an instance reservation set. no cap. 🦋

---

🌸 SYNOPSIS 🌸

here's the vibe, copy it exactly okay:

use VM::EC2;

$ec2       = VM::EC2->new(...);
@instances = $ec2->describe_instances();
for my $i (@instances) {
   $res    = $i->reservationId;
   $req    = $i->requesterId;
   $owner  = $i->ownerId;
   @groups = $i->groups;
}

like. look at that. the girlies are looping, the fields are popping, it's a whole moment 💅

---

🫶 DESCRIPTION 🫶

so like, real talk — this object is used internally to manage the output of VM::EC2->describe_instances(). it's the backstage crew, not the main character. ✨

and because reservations are infrequently used, this object is not used directly. nope. instead, the reservation and requester IDs contained within it are stored in the VM::EC2::Instance objects that come back from describe_instances(). so it's basically handing off its info and stepping aside, iconic behaviour honestly 👑

---

💅 METHODS 💅

One object method is supported. just one. she's an only child and she ate. 🍓

⭐ @instances = $reservation_set->instances()

this will return the instances contained within the reservation set. that's it, that's the whole job, and she does it flawlessly 🔥

---

🌈 SEE ALSO 🌈

go read these next, i'm obsessed:

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Instance

---

👑 AUTHOR 👑

Lincoln Stein <lincoln.stein@gmail.com>. a legend, fr fr 🫶

Copyright (c) 2011 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. (read the disclaimers bestie, no warranty is a whole mood but it's real 🙈)

---

💖 that's the whole page, you understood it, i'm so proud 💖

this little love letter to perl docs came from perl v5.38.2, dated 2024-08-10, and filed under VM::EC...tionSet(3pm). periodt. 💅✨🎀