AWS Security ChangesHomeSearch

AWS cli documentation change

Service: cli · 2026-06-19 · Documentation low

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

Summary

Updated AWS CLI version reference from 2.35.5 to 2.35.8. Enhanced documentation for ASN parameters (asn/asnLong) with clearer limitations and behavior details. Added new 'rateLimit' parameter for bandwidth allocation control on virtual interfaces.

Security assessment

The changes focus on clarifying ASN parameter usage and adding a bandwidth allocation feature. No evidence of vulnerability fixes or security incidents. The rateLimit parameter improves network management but isn't explicitly security-focused.

Diff

diff --git a/cli/latest/reference/directconnect/create-private-virtual-interface.md b/cli/latest/reference/directconnect/create-private-virtual-interface.md
index 285e33e77..9de47effe 100644
--- a//cli/latest/reference/directconnect/create-private-virtual-interface.md
+++ b//cli/latest/reference/directconnect/create-private-virtual-interface.md
@@ -15 +15 @@
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »
@@ -117,5 +117 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> ### 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.
+>>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
@@ -122,0 +119,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
+>>   * If you enter a 4-byte ASN for the `asn` parameter, 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 `asn` and `asnLong` fields.
@@ -132 +130 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> ### Note
+>> Note the following limitations when using `asnLong` :
@@ -134,3 +132,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> 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.
+>>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>>   * `asnLong` accepts any valid ASN value, regardless if it’s 2-byte or 4-byte.
+>>   * When using a 4-byte `asnLong` , the API response returns `0` for the legacy `asn` attribute 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 `asn` and `asnLong` fields.
@@ -216,0 +216,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
+> 
+> rateLimit -> (string)
+>
+>> The rate limit (bandwidth allocation) to apply to the virtual interface. The rate limit restricts the maximum bandwidth that the virtual interface can use on the parent connection.
@@ -221 +224 @@ Shorthand Syntax:
-    virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,mtu=integer,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,virtualGatewayId=string,directConnectGatewayId=string,tags=[{key=string,value=string},{key=string,value=string}],enableSiteLink=boolean
+    virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,mtu=integer,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,virtualGatewayId=string,directConnectGatewayId=string,tags=[{key=string,value=string},{key=string,value=string}],enableSiteLink=boolean,rateLimit=string
@@ -246 +249,2 @@ JSON Syntax:
-      "enableSiteLink": true|false
+      "enableSiteLink": true|false,
+      "rateLimit": "string"
@@ -433,5 +437 @@ asn -> (integer)
-> ### 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.
+>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
@@ -438,0 +439,2 @@ asn -> (integer)
+>   * If you enter a 4-byte ASN for the `asn` parameter, 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 `asn` and `asnLong` fields.
@@ -446 +448 @@ asnLong -> (long)
-> ### Note
+> Note the following limitations when using `asnLong` :
@@ -448,3 +450,4 @@ asnLong -> (long)
-> 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.
+>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>   * `asnLong` accepts any valid ASN value, regardless if it’s 2-byte or 4-byte.
+>   * When using a 4-byte `asnLong` , the API response returns `0` for the legacy `asn` attribute 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 `asn` and `asnLong` fields.
@@ -562,5 +565 @@ bgpPeers -> (list)
->>> ### 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.
+>>>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
@@ -567,0 +567,2 @@ bgpPeers -> (list)
+>>>   * If you enter a 4-byte ASN for the `asn` parameter, 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 `asn` and `asnLong` fields.
@@ -575 +576 @@ bgpPeers -> (list)
->>> ### Note
+>>> Note the following limitations when using `asnLong` :
@@ -577,3 +578,4 @@ bgpPeers -> (list)
->>> 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.
+>>>   * You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>>>   * `asnLong` accepts any valid ASN value, regardless if it’s 2-byte or 4-byte.
+>>>   * When using a 4-byte `asnLong` , the API response returns `0` for the legacy `asn` attribute 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 `asn` and `asnLong` fields.
@@ -708,0 +711,4 @@ siteLinkEnabled -> (boolean)
+rateLimit -> (string)
+
+> The rate limit (bandwidth allocation) applied to the virtual interface. The possible values are `50 Mbps` , `100 Mbps` , `200 Mbps` , `300 Mbps` , `400 Mbps` , `500 Mbps` , `1 Gbps` , `2 Gbps` , `5 Gbps` , or `10 Gbps` .
+
@@ -719 +725 @@ siteLinkEnabled -> (boolean)
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »