1VM::EC2::REST::internetU_sgearteCwoanyt(r3i)buted Perl DVoMc:u:mEeCn2t:a:tRiEoSnT::internet_gateway(3)
2
3
4
7 use VM::EC2 ':vpc'
8
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
94 VM::EC2
95
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.28.1 2019-02-02VM::EC2::REST::internet_gateway(3)