1VM::EC2::REST::internetU_sgearteCwoanyt(r3ipbmu)ted PerlVMD:o:cEuCm2e:n:tRaEtSiTo:n:internet_gateway(3pm)
2
3
4

NAME VM::EC2::REST::internet_gateway

SYNOPSIS

7        use VM::EC2 ':vpc'
8

METHODS

10       These methods provide methods for creating, associating and deleting
11       Internet Gateway objects.
12
13       Implemented:
14        AttachInternetGateway
15        CreateInternetGateway
16        DeleteInternetGateway
17        DescribeInternetGateways
18        DetachInternetGateway
19
20       Unimplemented:
21        (none)
22
23   $gateway = $ec2->create_internet_gateway()
24       This method creates a new Internet gateway. It takes no arguments and
25       returns a VM::EC2::VPC::InternetGateway object. Gateways are initially
26       independent of any VPC, but later can be attached to one or more VPCs
27       using attach_internet_gateway().
28
29   $success = $ec2->delete_internet_gateway($internet_gateway_id)
30   $success = $ec2->delete_internet_gateway(-internet_gateway_id=>$id)
31       This method deletes the indicated internet gateway. It may be called
32       with a single argument corresponding to the route table's ID, or using
33       the named form with argument -internet_gateway_id.
34
35   @gateways = $ec2->describe_internet_gateways(@gateway_ids)
36   @gateways = $ec2->describe_internet_gateways(\%filters)
37   @gateways = $ec2->describe_internet_gateways(-internet_gateway_id=>\@ids,
38       -filter             =>\$filters)
39       This method describes all or some of the internet gateways available to
40       you. You may use the filter to restrict the search to a particular type
41       of internet gateway using one or more of the filters described at
42       http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeInternetGateways.html.
43
44       Some of the commonly used filters are:
45
46        attachment.vpc-id       ID of one of the VPCs the gateway is attached to
47        attachment.state        State of the gateway, always "available"
48        tag:<key>               Value of a tag
49
50       On success this method returns a list of VM::EC2::VPC::InternetGateway
51       objects.
52
53   $boolean = $ec2->attach_internet_gateway($internet_gateway_id,$vpc_id)
54   $boolean = $ec2->attach_internet_gateway(-internet_gateway_id => $id,
55       -vpc_id              => $id)
56       This method attaches an internet gateway to a VPC.  You can use
57       internet gateway and VPC IDs, or their corresponding
58       VM::EC2::VPC::InternetGateway and VM::EC2::VPC objects.
59
60       Required arguments:
61
62        -internet_gateway_id ID of the network interface to attach.
63        -vpc_id              ID of the instance to attach the interface to.
64
65       On success, this method a true value.
66
67       Note that it may be more convenient to attach and detach gateways via
68       methods in the VM::EC2::VPC and VM::EC2::VPC::Gateway objects.
69
70        $vpc->attach_internet_gateway($gateway);
71        $gateway->attach($vpc);
72
73   $boolean = $ec2->detach_internet_gateway($internet_gateway_id,$vpc_id)
74   $boolean = $ec2->detach_internet_gateway(-internet_gateway_id => $id,
75       -vpc_id              => $id)
76       This method detaches an internet gateway to a VPC.  You can use
77       internet gateway and VPC IDs, or their corresponding
78       VM::EC2::VPC::InternetGateway and VM::EC2::VPC objects.
79
80       Required arguments:
81
82        -internet_gateway_id ID of the network interface to detach.
83        -vpc_id              ID of the VPC to detach the gateway from.
84
85       On success, this method a true value.
86
87       Note that it may be more convenient to detach and detach gateways via
88       methods in the VM::EC2::VPC and VM::EC2::VPC::Gateway objects.
89
90        $vpc->detach_internet_gateway($gateway);
91        $gateway->detach($vpc);
92

SEE ALSO

94       VM::EC2
95

AUTHOR

97       Lincoln Stein <lincoln.stein@gmail.com>.
98
99       Copyright (c) 2011 Ontario Institute for Cancer Research
100
101       This package and its accompanying libraries is free software; you can
102       redistribute it and/or modify it under the terms of the GPL (either
103       version 1, or at your option, any later version) or the Artistic
104       License 2.0.  Refer to LICENSE for the full license text. In addition,
105       please see DISCLAIMER.txt for disclaimers of warranty.
106
107
108
109perl v5.38.0                      2023-07-2V1M::EC2::REST::internet_gateway(3pm)