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

💖 VM::EC2::Region(3pm) 💖

okay bestie, welcome to the manual page for VM::EC2::Region, straight out of the User Contributed Perl Documentation. she's a lil object that describes AMI launch permissions and honestly? she's iconic for it. 🎀

---

✨ NAME ✨

VM::EC2::Region — Object describing AMI launch permissions 🦋

---

🌸 SYNOPSIS 🌸

here's the whole vibe in code form, no notes:

  use VM::EC2;

  $ec2       = VM::EC2->new(...);
  $image     = $ec2->describe_images('ami-12345');
  @users     = $image->launchPermissions;
  for (@users) {
    $group = $_->group;
    $user  = $_->userId;
  }

---

💅 DESCRIPTION 💅

so basically this object represents an Amazon machine image launch permission, and it gets handed back to you by VM::EC2::Image's launchPermissions() method. that's the whole main character arc fr fr. 👑

---

✨ METHODS ✨

these object methods are supported, and yes we're listing all of them because we do not skip:

• group — Name of a group with launch permissions. the only valid value here is "all". that's it. that's the list. 💀
• userId — Name of a user with launch permissions.

---

🌈 STRING OVERLOADING 🌈

when you use this object in a string context, it will interpolate the userId. 🫶

but if the userId is blank? then it interpolates as the group instead. plot twist, but make it useful. ✨

---

🦋 SEE ALSO 🦋

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Image

go read those too, they're all in the same friend group. 💜

---

👑 AUTHOR 👑

Lincoln Stein <lincoln.stein@gmail.com>. 📧

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. 🫡

ngl the license paragraph is giving "read it, it matters" and it does — don't skip the fine print bestie. 💖

---

aaaand that's the page! this one's from perl v5.38.2, dated 2024-08-10, and the manual name it lives under is VM::EC...ission(3pm) (she got truncated in the header, tragic, but we know who she is). mwah, go launch some images responsibly ✨🎀💅