ListRequestedServiceQuotaChangeHistory
Retrieves the quota increase requests for the specified Amazon Web Services service. Filter responses to return quota requests at either the account level, resource level, or all levels.
Request Syntax
{
"MaxResults": number
,
"NextToken": "string
",
"QuotaRequestedAtLevel": "string
",
"ServiceCode": "string
",
"Status": "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
-
Specifies the maximum number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value appropriate to the operation. If additional items exist beyond those included in the current response, the
NextToken
response element is present and has a value (is not null). Include that value as theNextToken
request parameter in the next call to the operation to get the next part of the results.Note
An API operation can return fewer results than the maximum even when there are more results available. 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
-
Specifies a value for receiving additional results after you receive a
NextToken
response in a previous request. ANextToken
response indicates that more output is available. Set this parameter to the value of the previous call'sNextToken
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
- QuotaRequestedAtLevel
-
Filters the response to return quota requests for the
ACCOUNT
,RESOURCE
, orALL
levels.ACCOUNT
is the default.Type: String
Valid Values:
ACCOUNT | RESOURCE | ALL
Required: No
- ServiceCode
-
Specifies the service identifier. To find the service code value for an Amazon service, use the ListServices operation.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 63.
Pattern:
[a-zA-Z][a-zA-Z0-9-]{1,63}
Required: No
- Status
-
Specifies that you want to filter the results to only the requests with the matching status.
Type: String
Valid Values:
PENDING | CASE_OPENED | APPROVED | DENIED | CASE_CLOSED | NOT_APPROVED | INVALID_REQUEST
Required: No
Response Syntax
{
"NextToken": "string",
"RequestedQuotas": [
{
"CaseId": "string",
"Created": number,
"DesiredValue": number,
"GlobalQuota": boolean,
"Id": "string",
"LastUpdated": number,
"QuotaArn": "string",
"QuotaCode": "string",
"QuotaContext": {
"ContextId": "string",
"ContextScope": "string",
"ContextScopeType": "string"
},
"QuotaName": "string",
"QuotaRequestedAtLevel": "string",
"Requester": "string",
"ServiceCode": "string",
"ServiceName": "string",
"Status": "string",
"Unit": "string"
}
]
}
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, indicates that more output is available than is included in the current response. Use this value in the
NextToken
request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until theNextToken
response element comes back asnull
.Type: String
Length Constraints: Maximum length of 2048.
Pattern:
^[a-zA-Z0-9/+]*={0,2}$
- RequestedQuotas
-
Information about the quota increase requests.
Type: Array of RequestedServiceQuotaChange objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You do not have sufficient permission 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 Amazon SDKs, see the following: