[jira] [Commented] (CLOUDSTACK-9088) migrateto parameter associated with migrateVirtualMachineWithVolume API needs an example

["ASF GitHub Bot (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CLOUDSTACK-9088?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15028576#comment-15028576 ] 

ASF GitHub Bot commented on CLOUDSTACK-9088:
--------------------------------------------

GitHub user anshul1886 opened a pull request:

    https://github.com/apache/cloudstack/pull/1126

    CLOUDSTACK-9088: Update the description for migrateVirtualMachineWithVolume api

    https://issues.apache.org/jira/browse/CLOUDSTACK-9088

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/anshul1886/cloudstack-1 CLOUDSTACK-9088

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/cloudstack/pull/1126.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #1126
    
----
commit 14c95b1871399d1988ff2fce50dab02e268bc765
Author: Anshul Gangwar <an...@citrix.com>
Date:   2015-06-17T05:25:07Z

    CLOUDSTACK-9088: Update the description for migrateVirtualMachineWithVolume api.

----


> migrateto parameter associated with migrateVirtualMachineWithVolume API needs an example
> ----------------------------------------------------------------------------------------
>
>                 Key: CLOUDSTACK-9088
>                 URL: https://issues.apache.org/jira/browse/CLOUDSTACK-9088
>             Project: CloudStack
>          Issue Type: Bug
>      Security Level: Public(Anyone can view this level - this is the default.) 
>          Components: API, Doc
>            Reporter: Anshul Gangwar
>            Assignee: Anshul Gangwar
>
> 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.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)