AWS Security ChangesHomeSearch

AWS cli documentation change

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

File: cli/latest/reference/directconnect/update-virtual-interface-attributes.md

Summary

Added --rate-limit parameter for bandwidth allocation updates and clarified ASN (asn/asnLong) behavior for 2-byte/4-byte ASNs

Security assessment

Changes introduce a new rate-limiting feature and clarify technical limitations of ASN parameters. No security vulnerabilities, exploits, or security features are mentioned or addressed.

Diff

diff --git a/cli/latest/reference/directconnect/update-virtual-interface-attributes.md b/cli/latest/reference/directconnect/update-virtual-interface-attributes.md
index b2576c3b4..c1e8c5302 100644
--- a//cli/latest/reference/directconnect/update-virtual-interface-attributes.md
+++ b//cli/latest/reference/directconnect/update-virtual-interface-attributes.md
@@ -15 +15 @@
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »
@@ -73,0 +74 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
+    [--rate-limit <value>]
@@ -114,0 +116,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
+`--rate-limit` (string)
+
+> The rate limit (bandwidth allocation) to apply to the virtual interface. Use this to update the bandwidth allocation on an existing virtual interface.
+
@@ -323,5 +328 @@ 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.
@@ -328,0 +330,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.
@@ -336,3 +339 @@ asnLong -> (long)
-> ### Note
-> 
-> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+> Note the following limitations when using `asnLong` :
@@ -340 +341,4 @@ asnLong -> (long)
->   * 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.
@@ -452,5 +456 @@ 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.
@@ -457,0 +458,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.
@@ -465,3 +467 @@ bgpPeers -> (list)
->>> ### Note
->>> 
->>> You can use `asnLong` or `asn` , but not both. We recommend using `asnLong` as it supports a greater pool of numbers.
+>>> Note the following limitations when using `asnLong` :
@@ -469 +469,4 @@ bgpPeers -> (list)
->>>   * 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.
@@ -598,0 +602,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` .
+
@@ -609 +616 @@ siteLinkEnabled -> (boolean)
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »