Skip to content

Resource: awsDxHostedTransitVirtualInterface

Provides a Direct Connect hosted transit virtual interface resource. This resource represents the allocator's side of the hosted virtual interface. A hosted virtual interface is a virtual interface that is owned by another AWS account.

Example Usage

/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as aws from "./.gen/providers/aws";
new aws.dxHostedTransitVirtualInterface.DxHostedTransitVirtualInterface(
  this,
  "example",
  {
    addressFamily: "ipv4",
    bgpAsn: 65352,
    connectionId: "${aws_dx_connection.example.id}",
    name: "tf-transit-vif-example",
    vlan: 4094,
  }
);

Argument Reference

The following arguments are supported:

  • addressFamily - (Required) The address family for the BGP peer. ipv4 or ipv6.
  • bgpAsn - (Required) The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
  • connectionId - (Required) The ID of the Direct Connect connection (or LAG) on which to create the virtual interface.
  • name - (Required) The name for the virtual interface.
  • ownerAccountId - (Required) The AWS account that will own the new virtual interface.
  • vlan - (Required) The VLAN ID.
  • amazonAddress - (Optional) The IPv4 CIDR address to use to send traffic to Amazon. Required for IPv4 BGP peers.
  • bgpAuthKey - (Optional) The authentication key for BGP configuration.
  • customerAddress - (Optional) The IPv4 CIDR destination address to which Amazon should send traffic. Required for IPv4 BGP peers.
  • mtu - (Optional) The maximum transmission unit (MTU) is the size, in bytes, of the largest permissible packet that can be passed over the connection. The MTU of a virtual transit interface can be either 1500 or 8500 (jumbo frames). Default is 1500.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

  • id - The ID of the virtual interface.
  • arn - The ARN of the virtual interface.
  • awsDevice - The Direct Connect endpoint on which the virtual interface terminates.
  • jumboFrameCapable - Indicates whether jumbo frames (8500 MTU) are supported.

Timeouts

Configuration options:

  • create - (Default 10M)
  • update - (Default 10M)
  • delete - (Default 10M)

Import

Direct Connect hosted transit virtual interfaces can be imported using the vifId, e.g.,

$ terraform import aws_dx_hosted_transit_virtual_interface.test dxvif-33cc44dd