← Back to team overview

openstack team mailing list archive

Re: OpenStack API Versioning Conventions

 

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.



Follow ups

References