[CLOUDSTACK-9088] migrateto parameter associated with migrateVirtualMachineWithVolume API needs an example

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.9.0
• Component/s: API, Doc
• Security Level: Public (Anyone can view this level - this is the default.)
• Assignee: Anshul Gangwar
• Reporter: Anshul Gangwar
• Created: 26/Nov/15 11:11
• Updated: 22/Apr/16 05:07
• Resolved: 22/Apr/16 05:07

Description

ISSUE:
API docs for migrateVirtualMachineWithVolume API does not clearly state the format for parameter "migrateto". The doc suggests that it accepts volume/pool pair but fails to mention:
1. Format.
2. If value for volume/pool should be name, ID or UUID.
3. Whether "pool" referenced here is source or target.
It may be difficult for users to perceive that the format needs to something like ...&migrateto[0].volume=<UUID>&migrateto[0].pool=<UUID>&...
We need to provide example for better understanding like we have done for "iptonetworklist" parameter associated with deployVirtualMachine API.