Common Request Parameters

The following table lists common parameters required in all Query or SOAP requests to SQS.

Parameter NameDescriptionUsed ByExample Value

Action

The action to perform.

Query and SOAP

CreateQueue

AWSAccessKeyId

Your Access Key ID. You must be signed up for SQS, or your requests will fail.

Query and SOAP

0AS7253JW73RRM652K02

Expires

The date and time at which the signature included in the request expires, in the format YYYY-MM-DDThh:mm:ssZ, as specified in the ISO 8601 standard. Query requests must include either Timestamp or Expires, but not both. SOAP requests not using WS-Security for authentication must not contain an Expires; only the Timestamp is allowed. For SOAP requests using WS-Security for authentication, see SOAP with WS-Security for information about handling message expiration.

Query and SOAP (see description)

2006-07-07T15:04:56Z

Signature

A request signature calculated as described in Request Authentication.

Query and SOAP

Qnpl4Qk/7tINHzfXCiT7VbBatDA=

SignatureVersion

The method used to construct the string to be signed, as explained in Authenticating Query Requests. The default value is 0. However, we highly recommend using SignatureVersion=1, which uses a stricter signature.

Query

Valid values: 0 or 1

Timestamp

The date and time the request is signed, in the format YYYY-MM-DDThh:mm:ssZ, as specified in the ISO 8601 standard. Query requests must include either Timestamp or Expires, but not both. SOAP requests not using WS-Security for authentication must contain a Timestamp. For SOAP requests using WS-Security for authentication, see SOAP with WS-Security for information about handling message expiration.

Query and SOAP (see description)

2006-07-07T15:04:56Z

Version

Required. The API version to use, as specified in the WSDL.

Query

2007-05-01

For Query requests, parameter values must be URL-encoded. This is true for any Query parameter passed to SQS and is typically necessary in the Signature, MessageId, and MessageBody parameters. Some clients do this automatically, but this is not the norm.