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

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

Github user swill commented on the pull request:

    https://github.com/apache/cloudstack/pull/1126#issuecomment-212976859
  
    We need to be doing this to more API calls, so I am happy we are starting 
to look at this.
    
    @DaanHoogland I don't think JSON adds much value here.  I think the main 
thing that needs to be in this documentation is how the URL query looks.  I 
have run into many situation where the URL query is very hard to figure out and 
I have spent way too much time doing trial and error on this.  I think the 
information presented here is the correct format and is useful.
    
    I will add this to my merge queue.  Thanks...


> 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)

Reply via email to