Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
VM::EC2::REST::vpn_gateway(3) User Contributed Perl Documentation VM::EC2::REST::vpn_gateway(3)

 use VM::EC2 ':vpc';

These methods create and manage Virtual Private Network Gateways (VGW).

Provides information on VPN gateways.
Return a series of VM::EC2::VPC::VpnGateway objects. When called with no arguments, returns all VPN gateways. Pass a list of VPN gateway IDs or use the assorted filters to restrict the search.
Optional parameters are:
 -vpn_gateway_id         ID of the gateway(s) to return information on. 
                         This can be a string scalar, or an arrayref.
 -filter                 Tags and other filters to apply.
The filter argument is a hashreference in which the keys are the filter names, and the values are the match strings. Some filters accept wildcards.
There are a number of filters, which are listed in full at
Here is a alpha-sorted list of filter names: attachment.state, attachment.vpc-id, availability-zone, state, tag-key, tag-value, tag:key, type, vpn-gateway-id

Creates a new virtual private gateway. A virtual private gateway is the VPC-side endpoint for a VPN connection. You can create a virtual private gateway before creating the VPC itself.
 -type switch is optional as there is only one type as of API 2012-06-15
Returns a VM::EC2::VPC::VpnGateway object on success

Deletes a virtual private gateway. Use this when a VPC and all its associated components are no longer needed. It is recommended that before deleting a virtual private gateway, detach it from the VPC and delete the VPN connection. Note that it is not necessary to delete the virtual private gateway if the VPN connection between the VPC and data center needs to be recreated.
 -vpn_gateway_id    -- The ID of the VPN gateway to delete.
Returns true on successful deletion

Attaches a virtual private gateway to a VPC.
 -vpc_id          -- The ID of the VPC to attach the VPN gateway to
 -vpn_gateway_id  -- The ID of the VPN gateway to attach
Returns the state of the attachment, one of:
attaching | attached | detaching | detached

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).
You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.
 -vpc_id          -- The ID of the VPC to detach the VPN gateway from
 -vpn_gateway_id  -- The ID of the VPN gateway to detach
Returns true on successful detachment.

Enables a virtual private gateway (VGW) to propagate routes to the routing tables of an Amazon VPC.
 -route_table_id        -- The ID of the routing table.
 -gateway_id            -- The ID of the virtual private gateway.
Returns true on successful enablement.

Disables a virtual private gateway (VGW) from propagating routes to the routing tables of an Amazon VPC.
 -route_table_id        -- The ID of the routing table.
 -gateway_id            -- The ID of the virtual private gateway.
Returns true on successful disablement.


Lance Kinley <>. Lincoln Stein <>.
Copyright (c) 2012 Loyalty Methods, Inc. 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.
2019-01-01 perl v5.28.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.