github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/aws/r/vpn_gateway_attachment.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_vpn_gateway_attachment"
     4  sidebar_current: "docs-aws-resource-vpn-gateway-attachment"
     5  description: |-
     6    Provides a Virtual Private Gateway attachment resource.
     7  ---
     8  
     9  # aws\_vpn\_gateway\_attachment
    10  
    11  Provides a Virtual Private Gateway attachment resource, allowing for an existing
    12  hardware VPN gateway to be attached and/or detached from a VPC.
    13  
    14  -> **Note:** The [`aws_vpn_gateway`](vpn_gateway.html)
    15  resource can also automatically attach the Virtual Private Gateway it creates
    16  to an existing VPC by setting the [`vpc_id`](vpn_gateway.html#vpc_id) attribute accordingly.
    17  
    18  ## Example Usage
    19  
    20  ```hcl
    21  resource "aws_vpc" "network" {
    22    cidr_block = "10.0.0.0/16"
    23  }
    24  
    25  resource "aws_vpn_gateway" "vpn" {
    26    tags {
    27      Name = "example-vpn-gateway"
    28    }
    29  }
    30  
    31  resource "aws_vpn_gateway_attachment" "vpn_attachment" {
    32    vpc_id         = "${aws_vpc.network.id}"
    33    vpn_gateway_id = "${aws_vpn_gateway.vpn.id}"
    34  }
    35  ```
    36  
    37  See [Virtual Private Cloud](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Introduction.html)
    38  and [Virtual Private Gateway](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_VPN.html) user
    39  guides for more information.
    40  
    41  ## Argument Reference
    42  
    43  The following arguments are supported:
    44  
    45  * `vpc_id` - (Required) The ID of the VPC.
    46  * `vpn_gateway_id` - (Required) The ID of the Virtual Private Gateway.
    47  
    48  ## Attributes Reference
    49  
    50  The following attributes are exported:
    51  
    52  * `vpc_id` - The ID of the VPC that Virtual Private Gateway is attached to.
    53  * `vpn_gateway_id` - The ID of the Virtual Private Gateway.
    54  
    55  ## Import
    56  
    57  This resource does not support importing.