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

πŸ“¦
version 1.28 Β· 7 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

πŸ’– VM::EC2::DB::SecurityGroup β€” it's giving RDS Database Security Group energy πŸŽ€

okay bestie, so this page lives in the User Contributed Perl Documentation section of the manual, and it's literally called VM::EC2::DB::SecurityGroup(3pm). It's an RDS Database Security Group object and it is so much less scary than it sounds. Let's get into it ✨


✨ SYNOPSIS ✨

here's the vibe, copy-paste ready, no cap:

$ec2     = VM::EC2->new(...);
@sg = $ec2->describe_db_security_groups;
foreach $group (@sg) {
  print $_,"\n" foreach $group->IPRanges;
  print $_->group_name,"\n" foreach $group->EC2SecurityGroups;
}

like… you spin up your $ec2, you ask for all the db security groups, and then for each group you're printing the IP ranges and the EC2 security groups by name. slay πŸ’…


🌸 METHODS 🌸

every one of these is a method on the object, bestie. here's the full roster, nothing skipped, we don't do that here:

  • DBSecurityGroupDescription β€” the description of the DB security group πŸ“
  • DBSecurityGroupName β€” the name of the DB security group 🏷️
  • EC2SecurityGroups β€” the EC2 security groups that are enabled in the DB group πŸ”₯
  • IPRanges β€” the IP Ranges that are enabled in the DB group 🌐
  • OwnerId β€” the Owner ID of the DB security group πŸ‘‘
  • VpcId β€” the VPC ID of the DB security group πŸ¦‹
  • ec2_security_groups β€” alias for EC2SecurityGroups (same thing, lowercase core)
  • ip_ranges β€” alias for IPRanges (again, same thing, just chiller)
bestie note: those last two are aliases, not separate features. ec2_security_groups = EC2SecurityGroups, ip_ranges = IPRanges. pick whichever one matches your vibe, they're identical. πŸ’–

🫢 DESCRIPTION 🫢

so this object represents a DB Security Group. that's it, that's the whole thing. it's the resultant output of these four calls:

  • VM::EC2->describe_db_security_groups()
  • VM::EC2->authorize_db_security_group_ingress()
  • VM::EC2->create_db_security_group()
  • VM::EC2->revoke_db_security_group_ingress()

so whether you're describing, creating, authorizing ingress, or revoking ingress β€” if a DB security group comes back, it comes back as one of these. iconic behavior honestly ⭐


πŸŽ€ STRING OVERLOADING πŸŽ€

when you use this object in a string context, it outputs the DB Security Group Name. that's the whole section, but it's an important one β€” it means you can just print the thing and get the name. main character energy fr fr πŸ’…


🌈 SEE ALSO 🌈

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

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

πŸ’œ AUTHOR πŸ’œ

Lance Kinley <lkinley@loyaltymethods.com>.

Copyright (c) 2013 Loyalty Methods, Inc.

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.


okay and that's the whole page bestie!! πŸ¦‹ this was perl v5.38.2, dated 2024-08-10, and the manual page is VM::EC...yGroup(3pm) (yes the name gets truncated like that, it's the terminal's fault not ours 😭). go forth and describe your db security groups, you've got this, periodt πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from