API Error Codes

There are two types of error codes, client and server.

Client error codes are generally caused by the client and might be an authentication failure or an invalid domain. In the SOAP API, these error codes are prefixed with Client. For example: Client.AuthFailure. In the REST API, these errors are accompanied by a 4xx HTTP response code.

Server error codes are generally caused by a server-side issue and should be reported. In the SOAP API, these error codes are prefixed with Server. For example: Server.Unavailable. In the REST API, these errors are accompanied by a 5xx HTTP response code.

The following table lists all Amazon SimpleDB error codes:

Error Description
AccessFailure Access to the resource " + resourceName + " is denied.
AuthFailure AWS was not able to validate the provided access credentials.
AuthMissingFailure AWS was not able to authenticate the request: access credentials are missing.
FeatureDeprecated As of API version 2007-11-07, the replace flag must be specified per attribute, not per item.
InternalError Request could not be executed due to an internal service error.
InvalidAction The action " + actionName + " is not valid for this web service.
InvalidHTTPAuthHeader The HTTP authorization header is bad, use " + correctFormat".
InvalidHttpRequest The HTTP request is invalid. Reason: " + reason".
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfDomains is invalid. MaxNumberOfDomains must be between 1 and 100.
InvalidNextToken The specified next token is not valid.
InvalidNumberPredicates Too many predicates in the query expression.
InvalidNumberValueTests Too many value tests per predicate in the query expression.
InvalidParameterCombination The parameter " + param1 + " cannot be used with the parameter " + param2".
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfItems is invalid. MaxNumberOfItems must be between 1 and 250.
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfDomains is invalid. MaxNumberOfDomains must be between 1 and 100.
InvalidParameterValue Value (" + value + ") for parameter " + paramName + " is invalid. " + reason".
InvalidParameterValue Value (" + value + ") for parameter Name is invalid. Value exceeds maximum length of 1024.
InvalidParameterValue Value (" + value + ") for parameter Value is invalid. Value exceeds maximum length of 1024.
InvalidParameterValue Value (" + value + ") for parameter DomainName is invalid.
InvalidParameterValue Value (" + value + ") for parameter Replace is invalid. The Replace flag should be either true or false.
InvalidQueryExpression The specified query expression syntax is not valid.
InvalidResponseGroups The following response groups are invalid: " + invalidRGStr".
InvalidService The Web Service " + serviceName + " does not exist.
InvalidSOAPRequest Invalid SOAP request. " + reason".
InvalidURI The URI " + requestURI + " is not valid.
InvalidWSAddressingProperty WS-Addressing parameter " + paramName + " has a wrong value: " + paramValue".
MalformedSOAPSignature Invalid SOAP Signature. " + reason".
MissingAction No action was supplied with this request.
MissingParameter The request must contain the specified missing parameter.
MissingParameter The request must contain the parameter " + paramName".
MissingParameter The request must contain the parameter ItemName.
MissingParameter The request must contain the parameter DomainName.
MissingParameter Attribute.Value missing for Attribute.Name='name'.
MissingParameter Attribute.Name missing for Attribute.Value='value'.
MissingWSAddressingProperty WS-Addressing is missing a required parameter (" + paramName + ")".
NoSuchDomain The specified domain does not exist.
NoSuchVersion The requested version (" + version + ") of service " + service + " does not exist.
NotYetImplemented Feature " + feature + " is not yet available".
NumberDomainsExceeded The number of domains was exceeded.
NumberDomainAttributesExceeded Too many attributes in this domain.
NumberDomainBytesExceeded Too many bytes in this domain.
NumberItemAttributesExceeded Too many attributes in this item.
RequestExpired Request has expired. " + paramType + " date is " + date".
RequestTimeout A timeout occurred when attempting to query domain <domain name> with query expression <query expression>. BoxUsage [<box usage value>]".
RequestThrottled Request <requestID> was denied due to request throttling.
ServiceOverload Service is currently overloaded; please try your request again later.
ServiceUnavailable Service Amazon SimpleDB is currently unavailable. Please try again later.
UnsupportedHttpVerb The requested HTTP verb is not supported: " + verb".
URITooLong The URI exceeded the maximum limit of " + maxLength".