Re: Confusion around domain and domainid in listDiskOfferings API Documentation

[Jessica Tomechak <je...@gmail.com>]

Hi Evan,
Sorry you found the API docs wanting. We have a great need for people to
help improve them. Could you please file this as a bug against
documentation? It's the same as filing anything else at
bugs.cloudstack.org- just pick "Doc" in the Component field. Paste in
anything from this email
thread that would be helpful to the person who fixes the bug. Thanks,

Jessica T.
CloudStack Tech Pubs

-----Original Message-----
> From: Evan Miller [mailto:Evan.Miller@citrix.com]
> Sent: Tuesday, July 03, 2012 1:29 PM
> To: cloudstack-users@incubator.apache.org
> Subject: RE: Confusion around domain and domainid in listDiskOfferings API
> Documentation
>
> Forget my previous post ... I get it now.
> If no domain is assigned when the disk offering is created, then no domain
> info will be associated with the particular disk offering.
> Somehow this needs to be better explained in the API docs.
>
> Regards,
> Evan
>
>
>
> -----Original Message-----
> From: heince kurniawan [mailto:heince@gmail.com]
> Sent: Tuesday, July 03, 2012 12:48 PM
> To: cloudstack-users@incubator.apache.org
> Subject: Re: Confusion around domain and domainid in listDiskOfferings API
> Documentation
>
> it's applicable if you assign domain when you create the disk offering.
>
> Regards,
> Heince
>
>
> On 04-Jul-2012, at 3:39 AM, Evan Miller wrote:
>
> > Running CloudStack Management Server:
> >
> >  v3.0.1.1
> >
> >
> >
> > OS:
> >
> >  [root@cumulus management]# uname -a
> >
> >  Linux cumulus.eng.citrite.net 2.6.32-220.el6.x86_64 #1 SMP Tue Dec 6
> > 19:48:22 GMT 2011 x86_64 x86_64 x86_64 GNU/Linux
> >
> >  [root@cumulus management]#
> >
> > Hi:
> >
> > In these listDiskOfferings API Docs :
> >
> > CloudStack v3.0 Root AdminAPI Reference, CloudStack v3.0 Domain Admin
> > API Reference, and CloudStack v3.0 User API Reference.
> >
> > There is a disclaimer about domain and domainid in Response Tags.
> > Why isn't there a similar disclaimer for domainid under Request
> parameters?
> > domainid doesn't work as a Request parameter.
> >
> > Maybe better yet ...
> >
> > Under Response Tags, why mention domain and domainid if it isn't
> applicable?
> >
> >
> > domain                the domain name this disk offering belongs to.
> Ignore this information as it is not currently applicable.
> > domainid            the domain ID this disk offering belongs to. Ignore
> this information as it is not currently applicable.
> >
> >
> > Confusing ...
> >
> > Regards,
> >
> > Evan Miller
> >
> > Citrix Systems. Inc.
> > Desktop and Cloud Engineering Infrastructure
> > 4988 Great America Parkway
> > Santa Clara, CA 95054
> >
> >
> >
>
>