VM::EC2::Region(3pm)

💖 VM::EC2::Region 💖

okay bestie, gather round, because this is VM::EC2::Region from the VM::EC2 Perl gang (that's the 3pm manual-page girlies, you know the vibe) 🎀

✨ NAME ✨

VM::EC2::Region — the object that's literally just describing an Amazon region. that's her whole job. she's an icon, she's an object, she's describing a region. periodt.

---

🌸 SYNOPSIS 🌸

here's the whole serve, verbatim, don't touch a single character:

use VM::EC2;

$ec2       = VM::EC2->new(...);
@regions   = $ec2->describe_regions();

$region  = $regions[0];
$name    = $region->regionName;
$url     = $region->regionEndpoint;
@zones   = $region->zones;

like… she's giving effortless. build the $ec2, ask for your @regions, grab $regions[0], and suddenly you've got a $name, a $url, and a whole @zones situation. slay 💅

---

🦋 DESCRIPTION 🦋

so this object represents an Amazon EC2 region, and it's the thing that gets handed back to you by VM::EC2->describe_regions(). that's it. that's the girl. she's a region. she knows things about herself. no cap ✨

---

👑 METHODS 👑

these object methods are supported, and yes we're listing every single one, because we don't skip:

• regionName — the name of the region, like "eu-west-1". her government name fr fr.
• regionEndpoint — the URL endpoint for AWS API calls, like "ec2.eu-west-1.amazonaws.com". this is the address where the API stuff happens 🌈
• zones — the list of availability zones inside this region, handed to you as VM::EC2::AvailabilityZone objects. a whole little squad of zone girlies 🫶

⚠️ okay IMPORTANT bestie, listen: before you use that endpoint to change the VM::EC2 endpoint with the endpoint() call, you have to prefix it with http:// or https://. if you don't, then https:// will be assumed. don't come crying to me when your endpoint is doing mystery things, i warned you 😭

---

💀 STRING OVERLOADING 💀

when you use this object in a string context, it will interpolate the regionName. so she just… says her name. main character behavior honestly ⭐

---

🌈 SEE ALSO 🌈

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

go read them, they're part of the friend group 💜

---

🎀 AUTHOR 🎀

Lincoln Stein <lincoln.stein@gmail.com>. shoutout to the legend 🫶

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.

💅 yes, that's the whole license paragraph, we do not paraphrase legal text in this house. LICENSE has the full text and DISCLAIMER.txt has the warranty disclaimers. read them, bestie.

---

and that's the page!! brought to you by perl v5.38.2, dated 2024-08-10, and this little manual page VM::EC2::Region(3pm) — mwah, go describe some regions, ily 💖✨