AWS cli documentation change
Summary
Updated AWS CLI version references from 2.35.5 to 2.35.8. Restructured ASN parameter documentation with clarifications on 2-byte/4-byte ASN usage limitations and added a new 'rateLimit' parameter for bandwidth allocation control.
Security assessment
The change adds documentation for the 'rateLimit' parameter which enforces bandwidth restrictions on virtual interfaces. This helps prevent resource exhaustion attacks and unauthorized bandwidth usage, enhancing security through traffic control. However, there's no evidence of a specific security vulnerability being patched.
Diff
diff --git a/cli/latest/reference/directconnect/allocate-public-virtual-interface.md b/cli/latest/reference/directconnect/allocate-public-virtual-interface.md index 2eab7926e..1fac9affa 100644 --- a//cli/latest/reference/directconnect/allocate-public-virtual-interface.md +++ b//cli/latest/reference/directconnect/allocate-public-virtual-interface.md @@ -15 +15 @@ - * [AWS CLI 2.35.5 Command Reference](../../index.html) » + * [AWS CLI 2.35.8 Command Reference](../../index.html) » @@ -126,5 +126 @@ 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. @@ -131,0 +128,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. @@ -141 +139 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/direct ->> ### Note +>> Note the following limitations when using `asnLong` : @@ -143,3 +141,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. @@ -221,0 +221,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. @@ -226 +229 @@ Shorthand Syntax: - virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,routeFilterPrefixes=[{cidr=string},{cidr=string}],tags=[{key=string,value=string},{key=string,value=string}] + virtualInterfaceName=string,vlan=integer,asn=integer,asnLong=long,authKey=string,amazonAddress=string,customerAddress=string,addressFamily=string,routeFilterPrefixes=[{cidr=string},{cidr=string}],tags=[{key=string,value=string},{key=string,value=string}],rateLimit=string @@ -253 +256,2 @@ JSON Syntax: - ] + ], + "rateLimit": "string" @@ -446,5 +450 @@ 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. @@ -451,0 +452,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. @@ -459,3 +461 @@ 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` : @@ -463 +463,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. @@ -575,5 +578 @@ 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. @@ -580,0 +580,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. @@ -588 +589 @@ bgpPeers -> (list) ->>> ### Note +>>> Note the following limitations when using `asnLong` : @@ -590,3 +591,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. @@ -721,0 +724,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` . + @@ -732 +738 @@ siteLinkEnabled -> (boolean) - * [AWS CLI 2.35.5 Command Reference](../../index.html) » + * [AWS CLI 2.35.8 Command Reference](../../index.html) »