AWS Security ChangesHomeSearch

AWS cli documentation change

Service: cli · 2025-08-16 · Documentation low

File: cli/latest/reference/directconnect/allocate-private-virtual-interface.md

Summary

Updated documentation to introduce `asnLong` parameter for BGP configuration, expanded ASN range validation, and clarified usage notes for ASN parameters. Adjusted CLI version references from 2.28.8 to 2.28.11.

Security assessment

The changes focus on expanding valid ASN ranges (1-2147483646 for `asn`, 1-4294967294 for `asnLong`) and introducing a new parameter to support larger values. While BGP configuration is network-security adjacent, there is no explicit mention of addressing a security vulnerability or weakness. The updates improve validation and prevent configuration errors but do not directly reference security threats or mitigations.

Diff

diff --git a/cli/latest/reference/directconnect/allocate-private-virtual-interface.md b/cli/latest/reference/directconnect/allocate-private-virtual-interface.md
index fa59acfbc..a32e31742 100644
--- a//cli/latest/reference/directconnect/allocate-private-virtual-interface.md
+++ b//cli/latest/reference/directconnect/allocate-private-virtual-interface.md
@@ -15 +15 @@
-  * [AWS CLI 2.28.8 Command Reference](../../index.html) »
+  * [AWS CLI 2.28.11 Command Reference](../../index.html) »
@@ -119 +119 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
+>> 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 `asnLong` instead.
@@ -121 +121,23 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> The valid values are 1-2147483647.
+>> ### Note
+>> 
+>> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>> 
+>>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+>> 
+
+>> 
+>> The valid values are 1-2147483646.
+> 
+> asnLong -> (long)
+>
+>> The ASN when allocating a new private virtual interface. The valid range is from 1 to 4294967294 for BGP configuration.
+>> 
+>> ### Note
+>> 
+>> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>> 
+>>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+>> 
+
@@ -162 +184 @@ Shorthand Syntax:
-    virtualInterfaceName=string,vlan=integer,asn=integer,mtu=integer,authKey=string,amazonAddress=string,addressFamily=string,customerAddress=string,tags=[{key=string,value=string},{key=string,value=string}]
+    virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,mtu=integer,authKey=string,amazonAddress=string,addressFamily=string,customerAddress=string,tags=[{key=string,value=string},{key=string,value=string}]
@@ -171,0 +194 @@ JSON Syntax:
+      "asnLong": long,
@@ -353 +376,5 @@ asn -> (integer)
-> The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
+> 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 `asnLong` instead.
+> 
+> ### Note
+> 
+> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
@@ -355 +382,17 @@ asn -> (integer)
-> The valid values are 1-2147483647.
+>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+> 
+
+
+asnLong -> (long)
+
+> The long ASN for the virtual interface. The valid range is from 1 to 4294967294 for BGP configuration.
+> 
+> ### Note
+> 
+> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+> 
+>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+> 
+
@@ -359 +402 @@ amazonSideAsn -> (long)
-> The autonomous system number (ASN) for the Amazon side of the connection.
+> The autonomous system number (AS) for the Amazon side of the connection.
@@ -440 +483,23 @@ bgpPeers -> (list)
->>> The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
+>>> 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 `asnLong` instead.
+>>> 
+>>> ### Note
+>>> 
+>>> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>>> 
+>>>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>>>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+>>> 
+
+>> 
+>> asnLong -> (long)
+>>
+>>> The long ASN for the BGP peer. The valid range is from 1 to 4294967294 for BGP configuration.
+>>> 
+>>> ### Note
+>>> 
+>>> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>>> 
+>>>   * The `asnLong` attribute accepts both ASN and long ASN ranges.
+>>>   * If you provide a value in the same API call for both `asn` and `asnLong` , the API will only accept the value for `asnLong` .
+>>> 
+
@@ -530 +595 @@ siteLinkEnabled -> (boolean)
-  * [AWS CLI 2.28.8 Command Reference](../../index.html) »
+  * [AWS CLI 2.28.11 Command Reference](../../index.html) »