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

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.

perl v5.38.2                                       2024-08-10                 VM::EC2::VPC::InternetGateway(3pm)

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.

Name

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

String Overloading

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

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;
        }