Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Returns the bandwidth rate limits of a gateway. By default, these limits are not set, which means no bandwidth rate limiting is in effect. This operation is supported only for the stored volume, cached volume, and tape gateway types. To describe bandwidth rate limits for S3 file gateways, use DescribeBandwidthRateLimitSchedule.

This operation returns a value for a bandwidth rate limit only if the limit is set. If no limits are set for the gateway, then this operation returns only the gateway ARN in the response body. To specify which gateway to describe, use the Amazon Resource Name (ARN) of the gateway in your request.

post/#X-Amz-Target=StorageGateway_20130630.DescribeBandwidthRateLimit

Headers

X-Amz-Target'StorageGateway_20130630.DescribeBandwidthRateLimit' required

Request body

GatewayARNstring required

The Amazon Resource Name (ARN) of the gateway. Use the <a>ListGateways</a> operation to return a list of gateways for your account and Amazon Web Services Region.

Response

Success

GatewayARNstring

The Amazon Resource Name (ARN) of the gateway. Use the <a>ListGateways</a> operation to return a list of gateways for your account and Amazon Web Services Region.

AverageUploadRateLimitInBitsPerSecinteger

The average upload bandwidth rate limit in bits per second. This field does not appear in the response if the upload rate limit is not set.

AverageDownloadRateLimitInBitsPerSecinteger

The average download bandwidth rate limit in bits per second. This field does not appear in the response if the download rate limit is not set.

Example response

{
  "AverageDownloadRateLimitInBitsPerSec": 204800,
  "AverageUploadRateLimitInBitsPerSec": 102400,
  "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B"
}