[ANNOUNCE] Third milestone release of RHEV-M REST API

[Eoghan Glynn]

Hi All,

We're happy to announce the third milestone release of the REST API
for Red Hat Enterprise Virtualization Manager.

Linux and Windows distributions of 0.9-milestone3 may be downloaded
from [1].

Signed individual artifacts are also deployed to maven and synch'd up
to the Central repository [2].

Highlights of this milestone release are summarized below, with the
corresponding trac[3] ticket ID specified where appropriate.

Main API additions:

 - Users and roles resources
 - Support for snapshots (#23)
 - Support for iSCSI and FCP storage domains (#59)
 - A storage collection under host resources (#59)
 - Support for adding/removing a network to/from a cluster (#57)
 - A NICs collection under host resources (#57)
 - Support for managing bonded NICs (#57)
 - Cluster compatibility levels (#25)
 - A versioned capabilities resource (#19)
 - Support for managing the users attached to a VM (#36)
 - VM display details and "ticket" action (#24)
 - Boot options in VM and template resources (#39)
 - Data center status (#45)

Improvements to the API implementation:

 - Re-use powershell instances to greatly speed up API accesses
 - Improved error reporting for missing required parameters (#40)
 - Improved error reporting of authentication failures (#68, #69)

Watch out for these incompatibilities with milestone2:

 - the 'cpus' collection has been moved under 'capabilities' (#25)
 - the 'user\domain' convention for specifying the username in the
   Authorization header is deprecated; use 'user@domain' instead (#70)

RESTEasy:

 - Fix for https://jira.jboss.org/browse/RESTEASY-426 which
   allows for POSTing to sub-collections (#47).

And, finally, miscellaneous bug fixes:

 - Work around xerces XML parser not being thread-safe (#49)
 - Fix several issues specific to running on RHEV-M 2.2 (#48)
 - Fix issue with powershell instances being reaped (#58)
 - Fix issue with adding VM devices (#47)
 - Fix broken data center update (#51)
 - Make VM type immutable post-creation (#46)
 - Fix issue with CLI and env variables (#50)
 - Resolve several issues when running under tomcat


As always, feedback is most welcome!


[1] https://fedorahosted.org/releases/r/h/rhevm-api
[2] http://repo2.maven.org/maven2/com/redhat/rhevm/api
[3] https://fedorahosted.org/rhevm-api/report/6