Github user DaanHoogland commented on the pull request:
https://github.com/apache/cloudstack/pull/1126#issuecomment-160941315
There is two problems to solve here;
1. how to document the api in a concise way. The information you are
providing is very useful and I think it makes sense to put it there
2. how to use the api. the formatting of the information is specific to the
client so I would try to use a more formal format or as in my exmple below in
json. I don't have a universal answer to this but in this case I would say,
though it is somewhate oververbose:
```
migrateto : [ {
volume: '71f43cd6-69b0-4d3b-9fbc-67f50963d60b',
pool: 'a382f181-3d2b-4413-b92d-b8931befa7e1'
},
{
volume: '88de0173-55c0-4c1c-a269-83d0279eeedf',
pool: '95d6e97c-6766-4d67-9a30-c449c15011d1'
},
{
volume: '1b331390-59f2-4796-9993-bf11c6e76225',
pool: '41fdb564-9d3b-447d-88ed-7628f7640cbc'
} ]
This example in cloudmoney:
migrateto[0].volume=<71f43cd6-69b0-4d3b-9fbc-67f50963d60b>&migrateto[0].pool=<a382f181-3d2b-4413-b92d-b8931befa7e1>&migrateto[1].volume=<88de0173-55c0-4c1c-a269-83d0279eeedf>&migrateto[1].pool=<95d6e97c-6766-4d67-9a30-c449c15011d1>&migrateto[2].volume=<1b331390-59f2-4796-9993-bf11c6e76225>&migrateto[2].pool=<41fdb564-9d3b-447d-88ed-7628f7640cbc>
```
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
