Common Errors

This section lists the errors shared by all actions. Errors specific to an action are listed in the topic about that action. See The Structure of a Response for information about the structure of an error response.

Error	Description	HTTP Status Code
AccessFailure	Requester does not have grants to access the resource.	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
AuthFailure	A value used for authentication could not be validated, such as `Signature`. If you're using the Query API, you can use the Amazon SQS Scratchpad to help you troubleshoot authentication issues. The Scratchpad is a simple HTML and JavaScript application that allows you to explore the 2008-01-01 Amazon SQS API without writing any code. The tool constructs a Query request and shows the string to sign and the final signature (using signature version 1) that you would include in the request. To download the Scratchpad, go to http://developer.amazonwebservices.com/connect/entry.jspa?externalID=1254&categoryID=30.	401
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
InvalidAction	The action specified was invalid.	400
InvalidParameterValue	One or more parameters cannot be validated.	400
InvalidParameter-Combination	Two parameters were specified that cannot be used together, such as `Timestamp` and `Expires`.	400
InvalidURI	The URL was invalid or was not a URL returned by a request to create a queue or list your queues.	400
MissingParameter	A required parameter is missing. See Example Response for MissingParameter Error.	400
NoSuchVersion	An incorrect version was specified in the request.	400
RequestExpired	The timestamp used with the signature has expired.	400
ServiceUnavailable	A required server needed by SQS is unavailable. This error is often temporary; resend the request after a short wait.	503
SOAP Fault: InvalidSecurity, Request Has Expired	The time to live set on the request has expired. See Example SOAP Fault Response.	200

Example Response for AuthFailure Error

The following sample response is for an AuthFailure error.

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

Example Response for MissingParameter Error

The following sample response is for a MissingParameter error. Note the presence of the MissingParameterName element.

<Response>
  <Errors>
    <Error>
      <Code>
         MissingParameter
      </Code>
      <Message>
         The request has a missing parameter Action
      </Message>
    </Error>
  </Errors>
  <awsRequestId>
     427cce5e-950b-4f82-b30d-d232796a81b1
  </awsRequestId>
  <MissingParameterName>
     Action
  </MissingParameterName>
</Response>

Example SOAP Fault Response

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

<soap:Fault>
   <soap:Code>
   <soap:Value>soap:Sender</soap:Value>
   <soap:Subcode>
	  <soap:Value>aws:InvalidSecurity</soap:Value>
   </soap:Subcode>
   </soap:Code>
   <soap:Reason>
   <soap:Text xml:lang=en-US>
        Request has expired
   </soap:Text>
   </soap:Reason>
   <soap:Detail>
   <aws:RequestId xmlns:aws=http://webservices.amazon.com/AWSFault/2005-15-09>
      0e46d0ca-a0ab-4730-9bca-219f064e16fd
   </aws:RequestId>
   </soap:Detail>
<soap:Fault>