If you see outdated content please navigate to the page footer and click "Report an issue on GitHub".
It is not user documentation and should not be treated as such.
User Documentation is available here.
REST Client Addon
Two methods for invoking REST-API requests are described bellow:
Using firefox rest client add on
- Add to firefox the rest-client add-on:
- Restart firefox
- Go to Tools –> REST Client
- Click on Authorization -> Basic Authorization button, enter username and password.
Username should include the domain. e.g.
Click on Headers -> Custom headers and add
name: Content-type value: application/xml
- Select “Get” method, put in URL field the server address, followed by
- Click on send
The expected result in the bottom window should be a red bar with text:
STATUS CODE: 200, OK
On the “Response Body” tab, the entire entities supported by the service are presented.
Selecting a specific entity and sending request for it will return the action supported for it and a collection of those entities.
The following link will return the entire list of VMs:
The response body contains a fixed list of “ready-to-paste” list which could be used to be pasted into the URL.
If wishes to run command/action:
- Change to “Post” method
Paste in the request body the request e.g. for adding a snapshot for a specific vm, type a url for that vm:
The request body:
This will add a new snapshot for VM with id
The second method is by using curl utility from the command line.
Example of adding new snapshot:
curl -v -u "admin@internal":letmein\! \ -H "Content-type: application/xml" \ -d '`<snapshot>` \ `<description>`New Snapshot for VM`</description>` \ `<vm id="61d0c568-62f5-4b8c-8548-7000beb27d7c" href="/api/vms/61d0c568-62f5-4b8c-8548-7000beb27d7c"/>` \ `</snapshot>`' \ http://localhost:8080/api/vms/61d0c568-62f5-4b8c-8548-7000beb27d7c/snapshots
The curl command line utility (provided by the curl package) could be enhanced by a script which could run in parallel to test various scenarios. It is also suitable for any type of non-functional tests (NFT). For full list of arguments refer to curl man pages.