Errors Common to all Actions

Topics

This section lists the errors shared by all actions. Errors specific to an action are listed in the topic about that action. For information about the structure of an error response, see Responses.

	Important
	We might throttle requests to Amazon SQS as necessary. When we throttle, we return a 503 (service unavailable) HTTP status code. Your system should be prepared to retry any request that receives a 503 code.

List of Errors

	Note
	For SOAP 1.1, SQS returns HTTP status code 500 for all faults. For SOAP 1.2, SQS returns the HTTP status code shown in the following table.

Error	Description	HTTP Status Code
`AccessDenied`	Access to the resource is denied.	403
`AuthFailure`	A value used for authentication could not be validated, such as `Signature`. For an example, see Example Response for AuthFailure Error.	401
`AWS.SimpleQueueService.InternalError`	There is an internal problem with SQS, which you cannot resolve. Retry the request. If the problem persists, contact us through the Amazon SQS Discussion Forums.	500
`AWS.SimpleQueueService.NonExistentQueue`	Queue does not exist.	400
`ConflictingQueryParameter`	The query parameter `<parameter>` is invalid. Its structure conflicts with that of another parameter.	400
`ElementNotSigned`	The element `<element>` is not signed. Returned for SOAP requests.	403
`InternalError`	There is an internal problem with SQS, which you cannot resolve. Retry the request. If the problem persists, contact us through the Amazon SQS Discussion Forums.	500
`InvalidAccessKeyId`	AWS was not able to validate the provided access credentials.	401
`InvalidAction`	The action specified was invalid.	400
`InvalidAddress`	The address `<address>` is not valid for this web service.	404
`InvalidHttpRequest`	Invalid HTTP request. Reason: `<reason>`.	400
`InvalidParameterCombination`	Two parameters were specified that cannot be used together, such as `Timestamp` and `Expires`.	400
`InvalidParameterValue`	One or more parameters cannot be validated.	400
`InvalidQueryParameter`	The query parameter `<parameter>` is invalid. Please see service documentation for correct syntax.	400
`InvalidRequest`	The service cannot handle the request. Request is invalid.	400
`InvalidSecurity`	The provided security credentials are not valid. Reason: `<reason>`.	403
`InvalidSecurityToken`	The security token used in the request is invalid. Reason: `<reason>`.	400
`MalformedSOAPSignature`	Invalid SOAP Signature. Reason: `<reason>`.	400
`MalformedVersion`	Version not well formed: `<version>`. Must be in YYYY-MM-DD format.	400
`MissingClientTokenId`	Request must contain AWSAccessKeyId or X.509 certificate.	403
`MissingCredentials`	AWS was not able to authenticate the request: access credentials are missing.	401
`MissingParameter`	A required parameter is missing.	400
`NoSuchVersion`	An incorrect version was specified in the request.	400
`NotAuthorizedToUseVersion`	Users who sign up to use Amazon SQS after February 1, 2008, must use API version 2008-01-01 and not previous API versions.	401
`RequestExpired`	The timestamp used with the signature has expired.	400
`RequestThrottled`	Request is throttled.	503
`ServiceUnavailable`	A required server needed by SQS is unavailable. This error is often temporary; resend the request after a short wait.	503
`SOAP11IncorrectDateFormat`	Timestamp must be in XSD date format.	400
`SOAP11MissingAction`	The <Action> request element is missing in SOAP 1.1 request.	400
`SoapBodyMissing`	Could not find the SOAP body in the request.	400
`SoapEnvelopeMissing`	Could not find the SOAP envelope in the request.	400
`SoapEnvelopeParseError`	Could not parse the SOAP envelope.	400
`UnknownEnvelopeNamespace`	Envelope Namespace must be for either SOAP 1.1: http://schemas.xmlsoap.org/soap/envelope, or SOAP 1.2: http://www.w3.org/2003/05/soap-envelope.	400
`WSSecurityCorruptSignedInfo`	Signed info is corrupt.	400
`WSSecurityCreatedDateIncorrectFormat`	Timestamp for created date must be in ISO8601 format.	400
`WSSecurityEncodingTypeError`	BinarySecurityToken must have EncodingType of `<type>`.	400
`WSSecurityExpiresDateIncorrectFormat`	Timestamp for expires date must be in ISO8601 format.	400
`WSSecurityIncorrectValuetype`	BinarySecurityToken has bad ValueType.	400
`WSSecurityMissingValuetype`	BinarySecurityToken must have attribute ValueType.	400
`WSSecurityMultipleCredentialError`	Request must not contain more than one BinarySecurityToken with valueType `<type>`.	400
`WSSecurityMultipleX509Error`	Request must not contain more than one BinarySecurityToken with valueType `<type>` or `<type>`.	400
`WSSecuritySignatureError`	Error while processing signature element.	400
`WSSecuritySignatureMissing`	SignatureValue is missing or empty.	400
`WSSecuritySignedInfoMissing`	Request has no SignedInfo.	400
`WSSecurityTimestampExpired`	Request has expired.	400
`WSSecurityTimestampExpiresMissing`	Timestamp must have Expires element.	400
`WSSecurityTimestampMissing`	Security Header Element is missing the timestamp element.	400
`WSSecurityX509CertCredentialError`	Request cannot contain both Credential and an X.509 certificate.	400
`X509ParseError`	Could not parse X.509 certificate.	400

Example Response for AuthFailure Error

The following sample response is for an AuthFailure error.

<ErrorResponse>
  <Error>
    <Type>
      Sender
    </Type>
    <Code>
      AuthFailure
    </Code>
    <Message>
      The provided signature is not valid for this access token
    </Message>
    <Detail/>
  </Error>
  <RequestID>
     ef3aba6a-dc84-4937-91bf-cef2ddd6775a
  </RequestID>
</ErrorResponse>

Example SOAP Fault Response

The following sample response shows a SOAP fault for an ElementNotSigned error.

<soap:Envelope 
     xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"       
     xmlns:aws="http://webservices.amazon.com/AWSFault/2005-15-09">
  <soap:Body>
    <soap:Fault>
      <faultcode>aws:Client.ElementNotSigned</faultcode>
      <faultstring>The element Timestamp is not signed.</faultstring>
      <detail>
        <aws:RequestId xmlns:aws="http://webservices.amazon.com/AWSFault/2005-15-09">
          ba5f0ea7-bc42-45a4-804b-6b9329b6e44f
        </aws:RequestId>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>