Amazon Elastic Compute Cloud Developer Guide API Versioning types (like string, boolean, int) are prefixed with xsd:. Complex types defined by the Amazon EC2 WSDL are prefixed with ec2:. Parameters that consist of lists of information are defined within our WSDL to require <info> tags around each member. Throughout the API, type references for parameters that accept such a list of values are specified using the notation type The type referred to in these instances is the type nested within the <info> tag (for Amazon EC2 types this is defined in the WSDL). For example, the <imagesSet> element in the following XML snippet is of type xsd:string: <imageId>ami-61a54008</imageId> <imageId>ami-61b54608</imageId> And the <instancesSet> element in the following XML snippet is of type ec2:RunInstanceItemType: <imageId>ami-60a54009</imageId> <minCount>10</minCount> <maxCount>30</maxCount> <imageId>ami-60b54209</imageId> <minCount>5</minCount> <maxCount>20</maxCount> API Versioning All Amazon EC2 API updates are versioned. This helps to minimize the impact of API changes on client software by making it possible to always send back a response that the client is capable of processing. We endeavor as far as possible to retain backwards compatibility with new API revisions. However, there may be occasions where an incompatible API change is required. In addition, in newer API releases existing responses may include additional fields, and depending on how client software is written it may or may not be able to handle these additional fields. By including a version in the request, a client guarantees that it will always be sent a response it expects. Each API revision is assigned a version in date form (the current API version is 2007-03-01). This version is included in the request as part of the document namespace when using our SOAP API and as a Version parameter when using our Query API. The response returned by Amazon EC2 will honor the version included in the request. Fields introduced in a later API version will not be returned in the response. SOAP clients that retrieve the Amazon EC2 WSDL at runtime and generate their requests dynamically using that WSDL should reference the WSDL for the version of the API the client was developed against. This will ensure client software continues to work even in the face of backwards incompatible API changes. The WSDL for each supported API version is available from the following URI: http://ec2.amazonaws.com/doc/<api-version>/AmazonEC2.wsdl API Version 2007-03-01 44
The new reader is still in beta!
(c) 2013 Tizra. All Rights reserved.