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.