AWS cli documentation change
Summary
1) Added clarification on 2-byte/4-byte ASN handling limitations and errors 2) Documented new 'rateLimit' field showing bandwidth allocation 3) Fixed minor text inconsistency 4) Updated CLI version references.
Security assessment
The 'rateLimit' field addition provides visibility into bandwidth controls that mitigate resource exhaustion risks. ASN handling improvements prevent misconfiguration errors but don't directly address vulnerabilities.
Diff
diff --git a/cli/latest/reference/directconnect/describe-virtual-interfaces.md b/cli/latest/reference/directconnect/describe-virtual-interfaces.md index c76fb8785..43977d08c 100644 --- a//cli/latest/reference/directconnect/describe-virtual-interfaces.md +++ b//cli/latest/reference/directconnect/describe-virtual-interfaces.md @@ -15 +15 @@ - * [AWS CLI 2.35.5 Command Reference](../../index.html) » + * [AWS CLI 2.35.8 Command Reference](../../index.html) » @@ -64 +64 @@ A virtual interface (VLAN) transmits the traffic between the Direct Connect loca - * If you’re using an `asn` , the response includes ASN value in both the `asn` and `asnLong` fields. + * If you’re using an `asn` , the response includes the ASN value in both the `asn` and `asnLong` fields. @@ -341,5 +341 @@ virtualInterfaces -> (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. @@ -346,0 +343,2 @@ virtualInterfaces -> (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. @@ -354 +352 @@ virtualInterfaces -> (list) ->>> ### Note +>>> Note the following limitations when using `asnLong` : @@ -356,3 +354,4 @@ virtualInterfaces -> (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. @@ -470,5 +469 @@ virtualInterfaces -> (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. @@ -475,0 +471,2 @@ virtualInterfaces -> (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. @@ -483,3 +480 @@ virtualInterfaces -> (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` : @@ -487 +482,4 @@ virtualInterfaces -> (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. @@ -615,0 +614,4 @@ virtualInterfaces -> (list) +>> +>> 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` . @@ -631 +633 @@ nextToken -> (string) - * [AWS CLI 2.35.5 Command Reference](../../index.html) » + * [AWS CLI 2.35.8 Command Reference](../../index.html) »