Nova/APIStyleGuide

API Style Guide
This primarily applies to the V3 API, but should be followed for V2 API changes where it makes sense

"server": { "os-config-drive:config_drive": "%(cdrive)s", "addresses": { "private": [ {                   "addr": "%(ip)s", "mac_addr": "aa:bb:cc:dd:ee:ff", "type": "fixed", "version": 4 }           ]        },
 * Alias names for extensions
 * Should be of the form foo-bar
 * lowercase, no contractions
 * Non core extension names should be prefixed with os-, eg os-access-ips
 * Use snake_case not CamelCase for body method parameters
 * Use server rather than instance for the API
 * When extending existing resources, new parameters (input and output) should use the new extension's alias as a prefix
 * eg where config drive extends the server response
 * Do not use WebDav HTTP error codes (eg 422 Unprocessable entity)
 * Ensure the layout of the XML input/output format is consistent with the JSON input/output format