github.com/mhlias/terraform@v0.6.12-0.20161118140322-a5d6410b912a/website/source/docs/providers/aws/r/dc_virtual_interface.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: dc_virtual_interface"
     4  sidebar_current: "docs-aws-resource-dc-virtual-interface"
     5  description: |-
     6    Provides a resource to create a DirectConnect Virtual Interface.
     7  ---
     8  
     9  # aws\_dc\_virtual_interface
    10  
    11  Provides a resource to create a DirectConnect Virtual Interface.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "aws_dc_virtual_interface" "vif" {
    17    connection_id = "dxcon-xyz123"
    18    virtual_interface_name = "my-vif"
    19    asn = "12345"
    20    vlan = "1024"
    21    auth_key = "my_super_secret_bgp_key"
    22    amazon_address = "10.0.0.45/30"
    23    customer_address = "10.0.0.46/30"
    24    interface_type = "private"
    25    virtual_gateway_id = "vgw-xyz123"
    26  }
    27  ```
    28  
    29  ## Argument Reference
    30  
    31  The following arguments are supported:
    32  
    33  * `connection_id` - (Required) The connection ID for the DirectConnect connection.
    34  * `virtual_interface_name` - (Required) The name of the virtual interface.
    35  * `asn` - (Required) The BGP autonomous system number.
    36  * `vlan` - (Required) The vlan id.
    37  * `auth_key` - (Optional) The BGP secret auth key.
    38  * `amazon_address` - (Optional) The IP along with the subnet mask for amazon's side of the small subnet used for the 2 routers BGP communication.
    39  * `customer_address` - (Optional) The IP along with the subnet mask for your side of the small subnet used for the 2 routers BGP communication.
    40  * `interface_type` - (Required) The type of the virtual interface [private,public].
    41  * `virtual_gateway_id` - (Required for interface_type = private) The id of the vpn gateway to be used.
    42  * `route_filter_prefixes` - (Required for interface_type = public) The list with routable cidrs to be filtered.
    43  
    44  
    45  -> **Note:** There are 2 types of DirectConnect virtual interfaces. Private as shown in the above example and public that do not need a virtual_gateway_id but require a route_filter_prefixes list.
    46  
    47  ## Attributes Reference
    48  
    49  The following attributes are exported:
    50  
    51  * `id` - The ID of virtual interface.
    52  * `amazon_address` - The IP address for amazon's interface (when autogenerated).
    53  * `customer_address` - The IP address for your interface (when autogenerated).
    54  
    55  
    56