AWS Security ChangesHomeSearch

AWS cli documentation change

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

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

Summary

Updated ASN usage notes and added rateLimit parameter documentation

Security assessment

The changes clarify ASN parameter behavior (2-byte vs 4-byte ASN handling) and add documentation for a new rateLimit parameter for bandwidth allocation. There's no evidence these changes address a specific security vulnerability, weakness, or incident. The rateLimit parameter appears to be a standard resource control feature rather than a security-specific capability.

Diff

diff --git a/cli/latest/reference/directconnect/allocate-transit-virtual-interface.md b/cli/latest/reference/directconnect/allocate-transit-virtual-interface.md
index 93485acc9..fca5109bf 100644
--- a//cli/latest/reference/directconnect/allocate-transit-virtual-interface.md
+++ b//cli/latest/reference/directconnect/allocate-transit-virtual-interface.md
@@ -15 +15 @@
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »
@@ -124,5 +124 @@ 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.
@@ -129,0 +126,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.
@@ -139 +137 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct
->> ### Note
+>> Note the following limitations when using `asnLong` :
@@ -141,3 +139,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.
@@ -211,0 +211,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.
@@ -216 +219 @@ Shorthand Syntax:
-    virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,mtu=integer,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,tags=[{key=string,value=string},{key=string,value=string}]
+    virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,mtu=integer,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,tags=[{key=string,value=string},{key=string,value=string}],rateLimit=string
@@ -238 +241,2 @@ JSON Syntax:
-      ]
+      ],
+      "rateLimit": "string"
@@ -462,5 +466 @@ virtualInterface -> (structure)
->> ### 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.
@@ -467,0 +468,2 @@ virtualInterface -> (structure)
+>>   * 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.
@@ -475,3 +477 @@ virtualInterface -> (structure)
->> ### 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` :
@@ -479 +479,4 @@ virtualInterface -> (structure)
->>   * 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.
@@ -591,5 +594 @@ virtualInterface -> (structure)
->>>> ### 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.
@@ -596,0 +596,2 @@ virtualInterface -> (structure)
+>>>>   * 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.
@@ -604 +605 @@ virtualInterface -> (structure)
->>>> ### Note
+>>>> Note the following limitations when using `asnLong` :
@@ -606,3 +607,4 @@ virtualInterface -> (structure)
->>>> 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.
@@ -736,0 +739,4 @@ virtualInterface -> (structure)
+> 
+> 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` .
@@ -748 +754 @@ virtualInterface -> (structure)
-  * [AWS CLI 2.35.5 Command Reference](../../index.html) »
+  * [AWS CLI 2.35.8 Command Reference](../../index.html) »