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

💖 NAME 💖

VM::EC2::REST::internet_gateway — bestie, this is the page that lets you Create, associate and delete Internet Gateway objects ✨ (it's part of the User Contributed Perl Documentation, iykyk 💅)

---

🌸 SYNOPSIS 🌸

use VM::EC2 ':vpc'

that's it. that's the whole vibe check. 🎀

---

✨ METHODS ✨

These methods provide methods for creating, associating and deleting Internet Gateway objects. yes we said methods twice, no we are not sorry, it's giving thorough 💅

Implemented:

• AttachInternetGateway
• CreateInternetGateway
• DeleteInternetGateway
• DescribeInternetGateways
• DetachInternetGateway

Unimplemented:

• (none) — not a single one, we ate and left zero crumbs 👑

---

🦋 $gateway = $ec2->create_internet_gateway()

okay so this one creates a brand new Internet gateway. it takes no arguments, like, at all, it just vibes. it returns a VM::EC2::VPC::InternetGateway object 🫶

and here's the tea: gateways are initially independent of any VPC, so at first they're literally single and ready to mingle. but later they can be attached to one or more VPCs using attach_internet_gateway() 💖

---

🎀 $success = $ec2->delete_internet_gateway($internet_gateway_id)

🎀 $success = $ec2->delete_internet_gateway(-internet_gateway_id=>$id)

this method deletes the indicated internet gateway. you can call it with a single argument corresponding to the route table's ID, or use the named form with the argument -internet_gateway_id. pick your fighter, both slay 💅

---

🌈 @gateways = $ec2->describe_internet_gateways(@gateway_ids)

🌈 @gateways = $ec2->describe_internet_gateways(\%filters)

🌈 @gateways = $ec2->describe_internet_gateways(-internet_gateway_id=>\@ids, -filter =>\$filters)

this method describes all or some of the internet gateways available to you. you may use the filter to restrict the search to a particular type of internet gateway using one or more of the filters described at:

http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeInternetGateways.html

Some of the commonly used filters are:

• attachment.vpc-id — ID of one of the VPCs the gateway is attached to
• attachment.state — State of the gateway, always "available"
• tag:<key> — Value of a tag

On success this method returns a list of VM::EC2::VPC::InternetGateway objects. a whole list. iconic behavior fr fr ⭐

---

🧚 $boolean = $ec2->attach_internet_gateway($internet_gateway_id,$vpc_id)

🧚 $boolean = $ec2->attach_internet_gateway(-internet_gateway_id => $id, -vpc_id => $id)

This method attaches an internet gateway to a VPC. You can use internet gateway and VPC IDs, or their corresponding VM::EC2::VPC::InternetGateway and VM::EC2::VPC objects. 💜

Required arguments:

• -internet_gateway_id — ID of the network interface to attach.
• -vpc_id — ID of the instance to attach the interface to.

On success, this method a true value. 😭 (we're quoting the ancestors here, the sentence is missing a verb but the truth remains: you get a true value back, no cap)

Note that it may be more convenient to attach and detach gateways via methods in the VM::EC2::VPC and VM::EC2::VPC::Gateway objects. like, lowkey way easier:

$vpc->attach_internet_gateway($gateway);
$gateway->attach($vpc);

---

🍓 $boolean = $ec2->detach_internet_gateway($internet_gateway_id,$vpc_id)

🍓 $boolean = $ec2->detach_internet_gateway(-internet_gateway_id => $id, -vpc_id => $id)

This method detaches an internet gateway to a VPC. You can use internet gateway and VPC IDs, or their corresponding VM::EC2::VPC::InternetGateway and VM::EC2::VPC objects. same energy as before, just the reverse direction bestie 🦋

Required arguments:

• -internet_gateway_id — ID of the network interface to detach.
• -vpc_id — ID of the VPC to detach the gateway from.

On success, this method a true value. (again!! the missing verb jumpscare 💀 but yes: true value on success)

Note that it may be more convenient to detach and detach gateways via methods in the VM::EC2::VPC and VM::EC2::VPC::Gateway objects. and yes, the original says "detach and detach" — we are NOT editing the source material, we respect the canon 🙈

$vpc->detach_internet_gateway($gateway);
$gateway->detach($vpc);

---

👑 SEE ALSO 👑

• VM::EC2

---

💜 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. 📜✨

---

and that's the whole page, bestie 🫶 this was perl v5.38.2, dated 2024-08-10, from VM::EC2...gateway(3pm) — go forth and attach those gateways, main character energy only 💅💖