NAME

VM::EC2::VPC::InternetGateway -- A VPC internet gateway

SYNOPSIS

use VM::EC2;
my $ec2      = VM::EC2->new(...);
my @gateways = $ec2->describe_internet_gateways;

for my $gw (@gateways) {
   print $gw->internetGatewayId,"\n";
   my @attachments = $gw->attachments;
}

DESCRIPTION

This object provides information about EC2 Virtual Private Cloud internet gateways, which, together with routing tables, allow instances within a VPC to communicate with the outside world.

METHODS

These object methods are supported:

internetGatewayId   -- the ID of the gateway
attachments         -- An array of VM::EC2::VPC::InternetGateway::Attachment
                       objects, each describing a VPC attached to this gateway.

This class supports the VM::EC2 tagging interface. See VM::EC2::Generic for information.

In addition, this object supports the following convenience methods:

attach($vpc)          -- Attach this gateway to the indicated VPC (ID or
                         VM::EC2::VPC object).
detach($vpc)          -- Detach this gateway from the indicated VPC (ID or
                         VM::EC2::VPC object).
refresh               -- Refreshes the contents of the object, primarily to
                         check for changes in attachment state.

STRING OVERLOADING

When used in a string context, this object will be interpolated as the internet gateway ID.

SEE ALSO

VM::EC2 VM::EC2::Generic VM::EC2::VPC

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.