[Openstack] OpenStack API Versioning Conventions

Bryan Taylor btaylor at rackspace.com
Wed Oct 12 16:15:29 UTC 2011


On 10/11/2011 10:28 AM, George Reese wrote:
> It's wildly inappropriate to equate a thing with its representation.

Unless the thing is itself a representation, yes. A resource can be ANYTHING: a server, a database record about a server, a car, a rock, the concept of love, the act of smiling, or a representation of a second resource, etc...

http://example.com/thing is the thing
http://example.com/v1/thing is the set of v1 representation of the thing
http://example.com/v2/thing is the set of v2 representation of the thing
http://example.com/v1/thing.json is the v1 JSON representation of the thing
http://example.com/v2/thing.xml is the v2 XML representation of the thing

A resource that represents a representation or set of representations of second resource is called a variant resource of the other.
This email may include confidential information. If you received it in error, please delete it.





More information about the Openstack mailing list