NovaServerActions

= Nova Server Actions =

The API resource  allows clients to POST a message to the server to take some specific action. These include REBOOT, SUSPEND, and the others listed in the API Developers Guide. The problem is that client applications must know the available actions in order to send them.

List of actions:
 * 1) changePassword
 * 2) reboot
 * 3) rebuild
 * 4) resize
 * 5) confirmResize
 * 6) revertResize
 * 7) createImage
 * 8) powerOn (extension?)

To make it easier to develop clients, the new resource  returns an enumerated list of actions along with natural-language descriptions. Moreover, once security restrictions are in place, this resource can be enhanced to provide a list of only those actions to which the currently-authenticated user is authorized.

The only HTTP method permitted is ; other methods must return 404 or other appropriate error status code.

This is an example return document:

   ... 

Note that the action s are hard-coded to match the available actions. The descriptions, however, should be in a format that permits them to be translated should the implementor so desire.

Clients only need to query this resource to gather a list of available actions; this could be used in a menu, help text, or simply to validate user input.