Request Parameters Common to All Actions

The following table lists common parameters used by Query and SOAP requests to SQS.

Parameter NameDescriptionUsed By

Action

The action to perform. For example: CreateQueue. For SOAP, the action is indicated by the name of the element in the SOAP request body (for more information, see Specifying the API Version).

Query

AWSAccessKeyId

Your Access Key ID. For example: 0AS7253JW73RRM652K02. For more information, see Your AWS Identifiers.

Query and SOAP

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 information about handling message expiration for SOAP requests using WS-Security for authentication, see SOAP with WS-Security.

Query and SOAP (see description)

Signature

A request signature (for information, see Request Authentication). For example: Qnpl4Qk/7tINHzfXCiT7VbBatDA=.

Query and SOAP

SignatureMethod

Required when you use signature version 2 with Query requests. For more information, see Query Request Authentication.

Query

SignatureVersion

For more information, see Query Request Authentication.

Query

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)

Version

The API version to use, as specified in the WSDL. For example: 2008-01-01.

Query

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, ReceiptHandle, and MessageBody parameters. Some clients do this automatically, but this is not the norm.