Amazon Elastic Compute Cloud
API Reference (API Version 2012-04-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

CreateVpnGateway

Description

Creates a new virtual private gateway. A virtual private gateway is the VPC-side endpoint for your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about Amazon Virtual Private Cloud and virtual private gateways, go to Adding an IPsec Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

Request Parameters

NameDescriptionRequired

Type

The type of VPN connection this virtual private gateway supports.

Type: String

Default: None

Valid Values: ipsec.1

Yes

AvailabilityZone

The Availability Zone option has been deprecated. The API will accept this option and ignore it.

Type: String

Default: None

No

Response Elements

The elements in the following table are wrapped in an CreateVpnGatewayResponse structure.

NameDescription

requestId

The ID of the request.

Type: xsd:string

vpnGateway

Information about the virtual private gateway.

Type: VpnGatewayType

Examples

Example Request

This example creates a virtual private gateway.

https://ec2.amazonaws.com/?Action=CreateVpnGateway
&Type=ipsec.1
&AUTHPARAMS

Example Response

<CreateVpnGatewayResponse xmlns="http://ec2.amazonaws.com/doc/2012-04-01/">
  <requestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</requestId>
  <vpnGateway>
    <vpnGatewayId>vgw-8db04f81</vpnGatewayId>
    <state>pending</state>
    <type>ipsec.1</type>
    <availabilityZone>us-east-1a</availabilityZone>
    <attachments/>
    <tagSet/>
  </vpnGateway>
</CreateVpnGatewayResponse>