Common Query Parameters

Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

Common Query Parameters

Request Parameters

All Query operations share a set of common parameters that must be present in each call:

NameDescriptionRequired

Action

Indicates the action to perform.

Example: RunInstances

Yes

Version

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

Example: 2008-12-01

Yes

AWSAccessKeyId

The Access Key ID for the request sender. This identifies the account which will be charged for usage of the service. The account with which the Access Key ID is associated must be signed up for Amazon EC2, or requests will not be accepted.

10QMXFEV71ZS32XQFTR2

Yes

Timestamp

The date and time at which the request is signed, in the format YYYY-MM-DDThh:mm:ssZ. For more information, go to

ISO 8601.

Example: 2006-07-07T15:04:56Z

Yes

Expires

The date and time at which the signature included in the request expires, in the format YYYY-MM-DDThh:mm:ssZ.

Example: 2006-07-07T15:04:56Z

Yes

Signature

The request signature. For more information, see Query API Authentication.

Example: Qnpl4Qk/7tINHzfXCiT7VbBatDA=

Yes

SignatureMethod

The hash algorithm you use to create the request signature. Valid values: HmacSHA256 | HmacSHA1. For more information, see Query API Authentication.

Example: HmacSHA256

Yes

SignatureVersion

The signature version you use to sign the request. Set this value to 2. For more information, see Query API Authentication.

Example: 2

Yes

[Note] Note

The Timestamp parameter can be used instead of Expires. Requests must include either Timestamp or Expires, but cannot contain both.

Parameter values must be URL-encoded. This is true for any Query parameter passed to Amazon EC2 and is typically necessary in the Signature parameter. Some clients do this automatically, but this is not the norm.

previous page start next page