NewPublicVirtualInterfaceAllocation
Information about a public virtual interface to be provisioned on a connection.
Contents
- virtualInterfaceName
 - 
               
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 (-).
Type: String
Required: Yes
 - vlan
 - 
               
The ID of the VLAN.
Type: Integer
Required: Yes
 - addressFamily
 - 
               
The address family for the BGP peer.
Type: String
Valid Values:
ipv4 | ipv6Required: No
 - amazonAddress
 - 
               
The IP address assigned to the Amazon interface.
Type: String
Required: No
 - asn
 - 
               
The autonomous system number (ASN). The valid range is from 1 to 2147483646 for Border Gateway Protocol (BGP) configuration. If you provide a number greater than the maximum, an error is returned. Use
asnLonginstead.- 
                     
You can use
asnLongorasn, but not both. We recommend usingasnLongas it supports a greater pool of numbers. - 
                     
If you provide a value in the same API call for both
asnandasnLong, the API will only accept the value forasnLong. - 
                     
If you enter a 4-byte ASN for the
asnparameter, the API returns an error. - 
                     
If you are using a 2-byte ASN, the API response will include the 2-byte value for both the
asnandasnLongfields. 
The valid values are 1-2147483646.
Type: Integer
Required: No
 - 
                     
 - asnLong
 - 
               
The ASN when allocating a new public virtual interface. The valid range is from 1 to 4294967294 for BGP configuration.
Note the following limitations when using
asnLong:- 
                     
You can use
asnLongorasn, but not both. We recommend usingasnLongas it supports a greater pool of numbers. - 
                     
asnLongaccepts any valid ASN value, regardless if it's 2-byte or 4-byte. - 
                     
When using a 4-byte
asnLong, the API response returns0for the legacyasnattribute since 4-byte ASN values exceed the maximum supported value of 2,147,483,647. - 
                     
If you are using a 2-byte ASN, the API response will include the 2-byte value for both the
asnandasnLongfields. - 
                     
If you provide a value in the same API call for both
asnandasnLong, the API will only accept the value forasnLong. 
Type: Long
Required: No
 - 
                     
 - authKey
 - 
               
The authentication key for BGP configuration. This string has a minimum length of 6 characters and and a maximun lenth of 80 characters.
Type: String
Required: No
 - customerAddress
 - 
               
The IP address assigned to the customer interface.
Type: String
Required: No
 - routeFilterPrefixes
 - 
               
The routes to be advertised to the AWS network in this Region. Applies to public virtual interfaces.
Type: Array of RouteFilterPrefix objects
Required: No
 - 
               
The tags associated with the public virtual interface.
Type: Array of Tag objects
Array Members: Minimum number of 1 item.
Required: No
 
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: