{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-direct-connect/refs/heads/main/json-schema/amazon-direct-connect-virtual-interface-schema.json", "title": "VirtualInterface", "description": "Information about a virtual interface.", "type": "object", "properties": { "ownerAccount": { "allOf": [ { "$ref": "#/components/schemas/OwnerAccount" }, { "description": "The ID of the Amazon Web Services account that owns the virtual interface." } ] }, "virtualInterfaceId": { "allOf": [ { "$ref": "#/components/schemas/VirtualInterfaceId" }, { "description": "The ID of the virtual interface." } ] }, "location": { "allOf": [ { "$ref": "#/components/schemas/LocationCode" }, { "description": "The location of the connection." } ] }, "connectionId": { "allOf": [ { "$ref": "#/components/schemas/ConnectionId" }, { "description": "The ID of the connection." } ] }, "virtualInterfaceType": { "allOf": [ { "$ref": "#/components/schemas/VirtualInterfaceType" }, { "description": "The type of virtual interface. The possible values are private and public." } ] }, "virtualInterfaceName": { "allOf": [ { "$ref": "#/components/schemas/VirtualInterfaceName" }, { "description": "The name of the virtual interface assigned by the customer network. The name has a maximum of 100 characters. The following are valid characters: a-z, 0-9 and a hyphen (-)." } ] }, "vlan": { "allOf": [ { "$ref": "#/components/schemas/VLAN" }, { "description": "The ID of the VLAN." } ] }, "asn": { "allOf": [ { "$ref": "#/components/schemas/ASN" }, { "description": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

The valid values are 1-2147483647.

" } ] }, "amazonSideAsn": { "allOf": [ { "$ref": "#/components/schemas/LongAsn" }, { "description": "The autonomous system number (ASN) for the Amazon side of the connection." } ] }, "authKey": { "allOf": [ { "$ref": "#/components/schemas/BGPAuthKey" }, { "description": "The authentication key for BGP configuration. This string has a minimum length of 6 characters and and a maximun lenth of 80 characters." } ] }, "amazonAddress": { "allOf": [ { "$ref": "#/components/schemas/AmazonAddress" }, { "description": "The IP address assigned to the Amazon interface." } ] }, "customerAddress": { "allOf": [ { "$ref": "#/components/schemas/CustomerAddress" }, { "description": "The IP address assigned to the customer interface." } ] }, "addressFamily": { "allOf": [ { "$ref": "#/components/schemas/AddressFamily" }, { "description": "The address family for the BGP peer." } ] }, "virtualInterfaceState": { "allOf": [ { "$ref": "#/components/schemas/VirtualInterfaceState" }, { "description": "

The state of the virtual interface. The following are the possible values:

" } ] }, "customerRouterConfig": { "allOf": [ { "$ref": "#/components/schemas/RouterConfig" }, { "description": "The customer router configuration." } ] }, "mtu": { "allOf": [ { "$ref": "#/components/schemas/MTU" }, { "description": "The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500." } ] }, "jumboFrameCapable": { "allOf": [ { "$ref": "#/components/schemas/JumboFrameCapable" }, { "description": "Indicates whether jumbo frames (9001 MTU) are supported." } ] }, "virtualGatewayId": { "allOf": [ { "$ref": "#/components/schemas/VirtualGatewayId" }, { "description": "The ID of the virtual private gateway. Applies only to private virtual interfaces." } ] }, "directConnectGatewayId": { "allOf": [ { "$ref": "#/components/schemas/DirectConnectGatewayId" }, { "description": "The ID of the Direct Connect gateway." } ] }, "routeFilterPrefixes": { "allOf": [ { "$ref": "#/components/schemas/RouteFilterPrefixList" }, { "description": "The routes to be advertised to the Amazon Web Services network in this Region. Applies to public virtual interfaces." } ] }, "bgpPeers": { "allOf": [ { "$ref": "#/components/schemas/BGPPeerList" }, { "description": "The BGP peers configured on this virtual interface." } ] }, "region": { "allOf": [ { "$ref": "#/components/schemas/Region" }, { "description": "The Amazon Web Services Region where the virtual interface is located." } ] }, "awsDeviceV2": { "allOf": [ { "$ref": "#/components/schemas/AwsDeviceV2" }, { "description": "The Direct Connect endpoint that terminates the physical connection." } ] }, "awsLogicalDeviceId": { "allOf": [ { "$ref": "#/components/schemas/AwsLogicalDeviceId" }, { "description": "The Direct Connect endpoint that terminates the logical connection. This device might be different than the device that terminates the physical connection." } ] }, "tags": { "allOf": [ { "$ref": "#/components/schemas/TagList" }, { "description": "The tags associated with the virtual interface." } ] }, "siteLinkEnabled": { "allOf": [ { "$ref": "#/components/schemas/SiteLinkEnabled" }, { "description": "Indicates whether SiteLink is enabled." } ] } } }