Class DxVirtualInterfaceConfig

NetworkConfig / DxGatewayConfig / DxVirtualInterfaceConfig

Direct Connect (DX) virtual interface (VIF) configuration. Use this configuration to create a virtual interface to a DX Gateway. Virtual interfaces enable access to your AWS services from your on-premises environment.

The following example creates a transit VIF called Accelerator-VIF in the Network account on a DX connection with resource ID dxcon-example:

Example

- name: Accelerator-VIF
  region: us-east-1
  connectionId: dxcon-example
  customerAsn: 64512
  interfaceName: Accelerator-VIF
  ownerAccount: Network
  type: transit
  vlan: 100

Hierarchy

  • DxVirtualInterfaceConfig

Implements

Constructors

constructor

Properties

addressFamily amazonAddress connectionId customerAddress customerAsn enableSiteLink interfaceName jumboFrames name ownerAccount region tags type vlan

Constructors

constructor

Properties

Readonly addressFamily

addressFamily: undefined | "ipv4" | "ipv6" = undefined

(OPTIONAL) The address family to use for this virtual interface.

Default - ipv4

Readonly amazonAddress

amazonAddress: undefined | string = undefined

(OPTIONAL) The peer IP address to use for Amazon's side of the virtual interface.

Default - randomly-generated by Amazon

Readonly connectionId

connectionId: string = ''

The resource ID of the DX connection the virtual interface will be created on

Remarks

This is the resource ID of an existing DX connection in your environment. Resource IDs should be the the format dxcon-xxxxxx

Readonly customerAddress

customerAddress: undefined | string = undefined

(OPTIONAL) The peer IP address to use for customer's side of the virtual interface.

Default - randomly-generated by Amazon

Readonly customerAsn

customerAsn: number = 64512

A Border Gateway Protocol (BGP) Autonomous System Number (ASN) for the customer side of the connection.

Remarks

This ASN must be unique from the Amazon side ASN. The ASN for the Amazon side is determined by the DX Gateway it is created on.

Note: The valid values are 1 to 2147483647

Readonly enableSiteLink

enableSiteLink: undefined | boolean = undefined

(OPTIONAL) Enable SiteLink for this virtual interface.

Default - false

Readonly interfaceName

interfaceName: string = ''

The name of the virtual interface. This name will show as the name of the resource in the AWS console and API.

Remarks

This name can be changed without replacing the physical resource.

Readonly jumboFrames

jumboFrames: undefined | boolean = undefined

(OPTIONAL) Enable jumbo frames for the virtual interface.

Default - standard 1500 MTU frame size

Readonly name

name: string = ''

A friendly name for the virtual interface. This name is used as a logical reference for the resource in the accelerator.

Remarks

CAUTION: Changing this value after initial deployment will cause the virtual interface to be recreated. Please be aware that any downstream dependencies may cause this property update to fail.

Readonly ownerAccount

ownerAccount: string = ''

The friendly name of the owning account of the DX connection.

Remarks

Please note this is the owning account of the physical DX connection, not the virtual interface.

If specifying an account that differs from the account of the Direct Connect Gateway, this will create a hosted VIF allocation from the connection owner account to the Direct Connect Gateway owner account. Hosted VIFs must be manually confirmed before they can be used or updated by the accelerator.

Readonly region

region: string = 'us-east-1'

The region of the virtual interface.

Remarks

Please note this region must match the region where the physical connection is hosted.

Readonly tags

tags: undefined | Tag[] = undefined

(OPTIONAL) An array of tags to apply to the virtual interface.

Readonly type

type: "private" | "transit" = 'transit'

The type of the virtual interface

Remarks

private virtual interfaces can only be created on DX gateways associated with virtual private gateways.

transit virtual interfaces can only be created on DX gateways associated with transit gateways.

Readonly vlan

vlan: number = 1

The virtual local area network (VLAN) tag to use for this virtual interface.

Remarks

This must be a unique VLAN tag that's not already in use on your connection.

The value must be between 1 and 4094

Settings

Member Visibility

Theme

Generated using TypeDoc