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 HTTP Status CodeSOAP Fault Code Prefix
AccessFailure Access to the resource " + resourceName + " is denied. 403 ForbiddenClient
AttributeDoesNotExist Attribute ("+ name + ") does not exist 404 Not FoundClient
AuthFailure AWS was not able to validate the provided access credentials. 403 ForbiddenClient
AuthMissingFailure AWS was not able to authenticate the request: access credentials are missing. 403 ForbiddenClient
ConditionalCheckFailed Conditional check failed. Attribute (" + name + ") value exists. 409 ConflictClient
ConditionalCheckFailed Conditional check failed. Attribute ("+ name +") value is ("+ value +") but was expected ("+ expValue +") 409 ConflictClient
ExistsAndExpectedValue Expected.Exists=false and Expected.Value cannot be specified together 400 Bad RequestClient
FeatureDeprecated The replace flag must be specified per attribute, not per item. 400 Bad RequestClient
IncompleteExpectedExpression If Expected.Exists=true or unspecified, then Expected.Value has to be specified 400 Bad RequestClient
InternalError Request could not be executed due to an internal service error. 500 Internal Server ErrorServer
InvalidAction The action " + actionName + " is not valid for this web service. 400 Bad RequestClient
InvalidHTTPAuthHeader The HTTP authorization header is bad, use " + correctFormat". 400 Bad RequestClient
InvalidHttpRequest The HTTP request is invalid. Reason: " + reason". 400 Bad RequestClient
InvalidLiteral Illegal literal in the filter expression. 400 Bad RequestClient
InvalidNextToken The specified next token is not valid. 400 Bad RequestClient
InvalidNumberPredicates Too many predicates in the query expression. 400 Bad RequestClient
InvalidNumberValueTests Too many value tests per predicate in the query expression. 400 Bad RequestClient
InvalidParameterCombination The parameter " + param1 + " cannot be used with the parameter " + param2". 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfDomains is invalid. MaxNumberOfDomains must be between 1 and 100. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfItems is invalid. MaxNumberOfItems must be between 1 and 2500. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter MaxNumberOfDomains is invalid. MaxNumberOfDomains must be between 1 and 100. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter " + paramName + " is invalid. " + reason". 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Name is invalid. Value exceeds maximum length of 1024. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Value is invalid. Value exceeds maximum length of 1024. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter DomainName is invalid. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Replace is invalid. The Replace flag should be either true or false. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Expected.Exists is invalid. Expected.Exists should be either true or false. 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Name is invalid.The empty string is an illegal attribute name 400 Bad RequestClient
InvalidParameterValue Value (" + value + ") for parameter Value is invalid. Value exceeds maximum length of 1024 400 Bad RequestClient
InvalidParameterValueValue (" + value + ") for parameter ConsistentRead is invalid. The ConsistentRead flag should be either true or false.400 Bad RequestClient
InvalidQueryExpression The specified query expression syntax is not valid. 400 Bad RequestClient
InvalidResponseGroups The following response groups are invalid: " + invalidRGStr. 400 Bad RequestClient
InvalidService The Web Service " + serviceName + " does not exist. 400 Bad RequestClient
InvalidSOAPRequest Invalid SOAP request. " + reason". 400 Bad RequestClient
InvalidSortExpression The sort attribute must be present in at least one of the predicates, and the predicate cannot contain the is null operator. 400 Bad RequestClient
InvalidURI The URI " + requestURI + " is not valid. 400 Bad RequestClient
InvalidWSAddressingProperty WS-Addressing parameter " + paramName + " has a wrong value: " + paramValue". 400 Bad RequestClient
InvalidWSDLVersion Parameter (" + parameterName +") is only supported in WSDL version 2009-04-15 or beyond. Please upgrade to new version 400 Bad RequestClient
MalformedSOAPSignature Invalid SOAP Signature. " + reason". 403 ForbiddenClient
MissingAction No action was supplied with this request. 400 Bad RequestClient
MissingParameter The request must contain the specified missing parameter. 400 Bad RequestClient
MissingParameter The request must contain the parameter " + paramName". 400 Bad RequestClient
MissingParameter The request must contain the parameter ItemName.400 Bad RequestClient
MissingParameter The request must contain the parameter DomainName.400 Bad RequestClient
MissingParameter Attribute.Value missing for Attribute.Name='name'.400 Bad RequestClient
MissingParameter Attribute.Name missing for Attribute.Value='value'.400 Bad RequestClient
MissingParameter No attributes for item ='" + itemName + "'.400 Bad RequestClient
MissingParameter The request must contain the parameter Name 400 Bad RequestClient
MissingWSAddressingProperty WS-Addressing is missing a required parameter (" + paramName + ")". 400 Bad RequestClient
MultipleExistsConditions Only one Exists condition can be specified 400 Bad RequestClient
MultipleExpectedNames Only one Expected.Name can be specified 400 Bad RequestClient
MultipleExpectedValues Only one Expected.Value can be specified 400 Bad RequestClient
MultiValuedAttribute Attribute (" + name + ") is multi-valued. Conditional check can only be performed on a single-valued attribute 409 ConflictClient
NoSuchDomain The specified domain does not exist. 400 Bad RequestClient
NoSuchVersion The requested version (" + version + ") of service " + service + " does not exist. 400 Bad RequestClient
NotYetImplemented Feature " + feature + " is not yet available". 401 UnauthorizedClient
NumberDomainsExceeded The domain limit was exceeded. 409 ConflictClient

NumberDomainAttributes

Exceeded

Too many attributes in this domain.409 ConflictClient
NumberDomainBytesExceeded Too many bytes in this domain.409 ConflictClient

NumberItemAttributes

Exceeded

Too many attributes in this item.409 ConflictClient

NumberSubmitted

AttributesExceeded

Too many attributes in a single call.409 ConflictClient

NumberSubmittedAttributesExceeded

Too many attributes for item itemName in a single call. Up to 256 attributes per call allowed.409 ConflictClient

NumberSubmittedItemsExceeded

Too many items in a single call. Up to 25 items per call allowed.409 ConflictClient
RequestExpired Request has expired. " + paramType + " date is " + date". 400 Bad RequestClient
RequestTimeout A timeout occurred when attempting to query domain <domain name> with query expression <query expression>. BoxUsage [<box usage value>]". 408 Request TimeoutClient
ServiceUnavailable Service Amazon SimpleDB is currently unavailable. Please try again later. 503 Service UnavailableServer
TooManyRequestedAttributes Too many attributes requested. 400 Bad RequestClient
UnsupportedHttpVerb The requested HTTP verb is not supported: " + verb". 400 Bad RequestClient
UnsupportedNextToken The specified next token is no longer supported. Please resubmit your query. 400 Bad RequestClient
URITooLong The URI exceeded the maximum limit of "+ maxLength". 400 Bad RequestClient