VM::EC2::VPC(3pm)

💖 VM::EC2::VPC — the manual page, but make it fashion 💖

okay bestie, welcome to VM::EC2::VPC, part of the VM::EC2 family of Perl modules — this is the one that lets you manage your EC2 VPC, aka your own lil private corner of the cloud 🏠✨

---

✨ SYNOPSIS ✨

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

use VM::EC2;
$ec2       - VM::EC2->new(...);
$vpc       = $ec2->create_vpc('10.0.0.0/16')     or die $ec2->error_str;
$subnet1   = $vpc->create_subnet('10.0.0.0/24')  or die $vpc->error_str;
$gateway   = $vpc->create_internet_gateway       or die $vpc->error_str;
$routeTbl  = $subnet1->create_route_table        or die $vpc->error_str;
$routeTbl->create_route('0.0.0.0/0' => $gateway) or die $vpc->error_str;

like, look at that. build a VPC, subnet it, give it a gateway, route table it, route the whole internet at it. iconic behavior 🌈🔥

---

🌸 DESCRIPTION 🌸

so for all the methods that every VM::EC2 object shares? those live over in VM::EC2::Generic. go peek at that one, bestie, we're not re-explaining them here 🫶

---

💅 METHODS 💅

the object methods (the basics, the essentials)

• vpcId — the ID of the VPC 💖
• state — where the VPC is at right now (pending, available) — it's giving character development
• cidrBlock — the CIDR block the VPC covers
• dhcpOptionsId — the ID of the set of DHCP options you've associated with the VPC, or "default"
• instanceTenancy — either "dedicated" or "default"
• isDefault — tells you if the VPC is a default VPC 👑

---

and ALSO, the convenience methods ✨ (these are the fun ones)

• dhcp_options() — hands you back a VM::EC2::VPC::DhcpOptions object
• current_state() — refreshes the object, then tells you its state. glow-up first, then vibe check 🦋
• current_status() — same as above, literally identical, it just exists for module consistency. periodt.
• set_dhcp_options($options) — associates the Dhcp option set with this VPC. $options can be a DhcpOptionsId string or a VM::EC2::VPC::DhcpOptions object. wanna assign no Dhcp options at all? use "default" or just pass no arguments 🎀
• internet_gateways() — returns the list of internet gateways attached to this VPC, as a list of VM::EC2::VPC::InternetGateway
• create_subnet($cidr_block [,$availability_zone] ) — creates a subnet with the CIDR block you gave it and returns the VM::EC2::VPC::Subnet object. the optional $availability_zone argument picks the zone for the subnet — skip it and Amazon picks one for you 🧚
• create_internet_gateway() — creates an internet gateway and immediately attaches it to this VPC. if it works you get a VM::EC2::VPC::InternetGateway object back 💫
• subnets() — returns the list of subnets attached to this VPC, as a list of VM::EC2::VPC::Subnet
• route_tables() — returns the list of route tables attached to this VPC, as a list of VM::EC2::VPC::RouteTable

---

🎀 STRING OVERLOADING 🎀

when you use this object in a string context, it gets interpolated as the VPC ID. so it just becomes its ID. main character energy fr fr 💅

---

👀 SEE ALSO 👀

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

---

💜 AUTHOR 💜

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

Copyright (c) 2012 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.

ok that's the legal bit and you do gotta read it, no skipping, it's the rules 📜✨

---

and that's the whole page bestie!! this was perl v5.38.2, dated 2024-08-10 — so if you're reading this from the future, hi, you're doing amazing, go build a VPC 🌸💖🦋