VM::EC2::Group(3pm)

💖 VM::EC2::Group 💖

okay bestie, so this is the manual page for VM::EC2::Group, which lives in the User Contributed Perl Documentation section (3pm). it's a tiny little object and honestly it's giving hype girl for a bigger object, but you need it, so let's go 💅

---

✨ NAME ✨

VM::EC2::Group — the object that describes an Amazon EC2 security group name 🎀

---

🌸 SYNOPSIS 🌸

use VM::EC2;

$ec2      = VM::EC2->new(...);
$instance = $ec2->describe_instances(-instance_id=>'i-12345');
my @groups = $instance->groups;
for my $g (@groups) {
  my $id      = $g->groupId;
  my $name    = $g->groupName;

  # get the security group details
  my $sg      = $ec2->describe_security_group($g);
  my $permissions = $sg->ipPermissions;
}

like, look at that loop. she's just vibing through your groups and grabbing the groupId and the groupName. then if you want the actual tea about what ports are open, you hand the group object over to describe_security_group and she comes back with ipPermissions. iconic. 🔥

---

🦋 DESCRIPTION 🦋

so basically: this object is just the name and the ID of a security group. that's it. that's her whole personality. 🙈

she gets returned by an instance's groups() method.

⚠️ real talk though: this object does not give you any of the details about the security group. no ports, no rules, nothing. she's the name tag, not the dossier, iykyk.

but!! you can absolutely use her in a call to VM::EC2->describe_security_group() to go get the actual details — you know, the security group's allowed ports and all that. so she's a little key 🔑 that unlocks the bigger info. we love a supporting character with main character energy.

---

👑 METHODS 👑

these object methods are supported, bestie:

• groupId — the group ID 💜
• groupName — the group's name 🌸

and for convenience, because she's sweet like that, the object also provides a permissions() method that will return the fully detailed VM::EC2::SecurityGroup:

$details = $group->permissions()

see VM::EC2::SecurityGroup for all of that. 🫶

---

🎀 STRING OVERLOADING 🎀

when you use this object in a string context, it will interpolate the groupId. so yes, you can just drop her in a "$group" and she'll show up with her ID. no cap. ✨

---

🌈 SEE ALSO 🌈

• VM::EC2
• VM::EC2::Object
• VM::EC2::Generic
• VM::EC2::SecurityGroup

go read those too, they're the rest of the 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.

📜 so yeah, GPL v1-or-later or Artistic 2.0, your call, both are slay. but pls actually read LICENSE and DISCLAIMER.txt, the warranty situation is not a joke bestie 😭

---

and that's the whole page! this doc is from perl v5.38.2, dated 2024-08-10, and it documents VM::EC2::Group(3pm). periodt. 💅✨🦋