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.

ListAWSDefaultServiceQuotas

Lists all default service quotas for the specified AWS service or all AWS services. ListAWSDefaultServiceQuotas is similar to ListServiceQuotas except for the Value object. The Value object returned by ListAWSDefaultServiceQuotas is the default value assigned by AWS. This request returns a list of all service quotas for the specified service. The listing of each 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. 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: String

Length Constraints: Maximum length of 2048.

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

Required: No

ServiceCode

Specifies the service that you want to use.

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

(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}$

Quotas

A list of the quotas in the account with the AWS default values.

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: