2. Document change history

This version of the Developer Guide replaces and obsoletes all previous versions. The most recent changes are described in the table below:

Revision DateSummary of Changes

September 10, 2013

  • Added the 422 return code to the reboot server operation.

May 22, 2013

  • Updated the book title for consistency.

April 27, 2013

  • Changed title of this book to reflect that it contains Compute extensions.

April 17, 2013

  • Added the server admin actions extension.

May 30, 2012

  • Added more descriptive information about the request body attributes to the create server API operation.

May 2, 2012

  • Added SHUTOFF to the list of server status values for the list servers API operation.

  • Updated the description for the SUSPENDED server status value for the list servers API operation.

April 24, 2012

  • Updated to use color-coded syntax formatting in request and response examples.

March 25, 2012

  • Added descriptions of URI parameters and request body attributes for API operations.

February 14, 2012

  • Updated the API version from v1.1 to v2.

  • No longer use mimetype parameters to denote version.

November 8, 2011

  • Removed DRAFT designation.

September 8, 2011

  • Added limit and marker parameters to list operations.

  • The rebuild action behaves just like create: an imageRef is used and a password may be specified.

  • Added tenant and user_id attributes to server and image.

  • Added vcpus attribute to flavors.

  • The flavorRef attribute is now used in the resize action.

July 23, 2011

  • Added missing response examples for server update.

  • Ensure consistent HTTP status codes for all resources.

  • Clarifications on setting and changing a server password.

  • Minor updates to metadata section for clarity.

  • Discuss alternate links.

  • Removed version number from compute media types — use a media type parameter instead.

  • Bought back the flavorRef and imageRef server attributes these are now only used when creating a server.

  • Made the create image operation a server action.

  • Added minDisk and minRam filters to flavor lists.

  • Added minDisk and minRam attributes to images.

  • Asynchronous faults may now contain a timestamp.

  • Changes-since request returns an empty list rather than a 304.

  • Added DELETED image status.

  • Fix content length in Example 1.2, “XML response with headers”.

  • Fixed bad request error code in Section 2.1.2.2, “Server passwords”.

  • Compact image, server, and flavor lists should contain IDs, names, and links (Any kind of link may be included — not just self links).

  • Changed metadata URI from .../meta to .../metadata for consistency.

June 29, 2011

  • Renamed Primary IP to Access IP.

June 23, 2011

  • Many minor updates based on community feedback.

  • Removed sections on Content Compression, Persistent Connections, and Caching — these are operator specific. Added section on HTTP.

  • A Location header is returned when creating servers/images.

  • Added filters to collection of Image, Servers, and Flavors.

  • Added asynchronous faults.

  • Updates to links and references. Remove serverRef, imageRef, and flavorRef and instead embed one entity in another to provide links.

  • Added primary IP addresses.

  • Added forbidden fault.

  • We now use a single bookmark link per entity regardless of mimetype.

  • Collections are now sorted by create time.

  • Previous links are no longer required.

  • Added the ability to create or update multiple metadata items simultaneously.

  • Minor cleanups to server and image state machine.

  • Update to JSON collection format.

  • Replace integer IDs with UUIDs.

  • Removed affinityID, this will likely come in as an extension.

April 25, 2011

  • Some minor cleanups in preparation for OpenStack Summit discussion.

March 11, 2011

  • Many minor updates based on community feedback.

  • Updates to resource linking and references.

  • Better description of paginated collections.

  • Metadata supported in servers and images.

  • Dropped support for shared IP groups.

  • IPs organized by network ID, versus showing only public and private IPs.

  • Generalized affinity ID.

February 9, 2011

  • Initial release.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page


loading table of contents...