VM::EC...T::zone(3pm)

💖 VM::EC2::REST::zone 💖

okay bestie, so this is the VM::EC2::REST::zone page from the User Contributed Perl Documentation corner of the internet, and it's literally all about fetching info on EC2 regions and availability zones. yes. that's the whole vibe. slay. 💅

---

✨ NAME ✨

VM::EC2::REST::zone — Fetch information on EC2 regions and availability zones 🦋

---

🌸 SYNOPSIS 🌸

use VM::EC2 qw(:standard);

that's it. that's the setup. iconic. 👑

---

🌈 EC2 REGIONS AND AVAILABILITY ZONES 🌈

okay so this section is where the methods live, and they're the ones that let you fetch info about EC2 regions and availability zones. and like, they don't return random hashes or vibes — they hand you back actual objects of type VM::EC2::Region and VM::EC2::AvailabilityZone. main character objects, fr fr. 🎀

Implemented:

• DescribeAvailabilityZones
• DescribeRegions

Unimplemented:

• (none)

ngl, "unimplemented: (none)" is the most satisfying line in any manpage. we love a complete queen. 💀✨

---

🧚 @regions = $ec2->describe_regions(@list)

🧚 @regions = $ec2->describe_regions(-region_name=>\@list)

so this one describes regions and gives you back a list of VM::EC2::Region objects. 🫶

call it with no arguments and you get all the regions, periodt. but if you wanna narrow it down, you can pass a list of regions in either of the two forms shown above. and yes, glob-style wildcards are allowed — like "*east" — so go off. 🌟

---

🦋 @zones = $ec2->describe_availability_zones(@names)

🦋 @zones = $ec2->describe_availability_zones(-zone_name=>\@names,-filter=>\%filters)

this one describes availability zones and returns a list of VM::EC2::AvailabilityZone objects. 💜

no arguments? you get all the availability regions. 💫 you can also hand it a list of zones in either of the two forms shown above to restrict what comes back. and same deal as before — glob-style wildcards like "*east" are allowed, bestie. 😌

and here's the lil plot twist 🫣 — if you pass a single argument that's a hashref, it gets treated as a -filter argument. so like:

$ec2->describe_availability_zones({state=>'available'})

is equivalent to:

$ec2->describe_availability_zones(-filter=>{state=>'available'})

same energy, different outfit. 💅

availability zone filters are described over at: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeAvailabilityZones.html

---

⭐ SEE ALSO ⭐

• VM::EC2

go read that one too, iykyk. 📚

---

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

okay so lowkey important: the license stuff above is not decoration, bestie — it's the actual legal tea. read LICENSE and DISCLAIMER.txt fr fr. 🙈

---

and that's the whole page!! 🌸 this was documented by perl v5.38.2 on 2024-08-10, and yeah the page title got a lil squished into VM::EC...T::zone(3pm) — she's a little mysterious, we respect it. 💖 bye bestie, go describe some zones!! 🦋✨👑