Service Quotas
API Reference (API Version 2019-06-24)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

ListServiceQuotas

Lists all service quotas for the specified AWS service. This request returns a list of the service quotas for the specified service. You'll see the default values are the values that AWS provides for the quotas.

Note

Always check the NextToken response parameter when calling any of the List* operations. These operations can return an unexpected list of results, even when there are more results available. When this happens, the NextToken response parameter contains a value to pass the next call to the same API to request the next part of the list.

Request Syntax

{ "MaxResults": number, "NextToken": "string", "ServiceCode": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MaxResults

(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, the response defaults to a value that's specific to the operation. If additional items exist beyond the specified maximum, the NextToken element is present and has a value (isn't null). Include that value as the NextToken request parameter in the call to the operation to get the next part of the results. You should check NextToken after every operation to ensure that you receive all of the results.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

NextToken

(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.

Type: String

Length Constraints: Maximum length of 2048.

Pattern: ^[a-zA-Z0-9/+]*={0,2}$

Required: No

ServiceCode

The identifier for a service. When performing an operation, use the ServiceCode to specify a particular service.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: [a-zA-Z][a-zA-Z0-9-]{1,63}

Required: Yes

Response Syntax

{ "NextToken": "string", "Quotas": [ { "Adjustable": boolean, "ErrorReason": { "ErrorCode": "string", "ErrorMessage": "string" }, "GlobalQuota": boolean, "Period": { "PeriodUnit": "string", "PeriodValue": number }, "QuotaArn": "string", "QuotaCode": "string", "QuotaName": "string", "ServiceCode": "string", "ServiceName": "string", "Unit": "string", "UsageMetric": { "MetricDimensions": { "string" : "string" }, "MetricName": "string", "MetricNamespace": "string", "MetricStatisticRecommendation": "string" }, "Value": number } ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

If present in the response, this value indicates there's more output available that what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null).

Type: String

Length Constraints: Maximum length of 2048.

Pattern: ^[a-zA-Z0-9/+]*={0,2}$

Quotas

The response information for a quota lists all attribute information for the quota.

Type: Array of ServiceQuota objects

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 400

IllegalArgumentException

Invalid input was provided.

HTTP Status Code: 400

InvalidPaginationTokenException

Invalid input was provided.

HTTP Status Code: 400

NoSuchResourceException

The specified resource does not exist.

HTTP Status Code: 400

ServiceException

Something went wrong.

HTTP Status Code: 500

TooManyRequestsException

Due to throttling, the request was denied. Slow down the rate of request calls, or request an increase for this quota.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: