The script can be run something like this:

/cloudstack/tools/apidoc$ ./build-apidoc.sh 4.19.0.0 
../../client/target/cloud-client-ui-4.19.0.0.jar 
../../client/target/cloud-client-ui-4.19.0.0.jar ./target

Which as Wei mentioned is what is done when you build apidoc

Thanks
 


________________________________
From: Wei ZHOU <ustcweiz...@gmail.com>
Sent: June 14, 2024 10:21 AM
To: dev@cloudstack.apache.org <dev@cloudstack.apache.org>
Subject: Re: Endpoint response is different than the docs

Hi,

you can run "mvn -P developer,systemvm clean install -pl tools/apidoc/"
the api doc can be found at tools/apidoc/target/xmldoc/apis/

The api parameters and responses come from the java classes.

-Wei

On Fri, Jun 14, 2024 at 4:11 PM Ahmed Awlaqi
<ahmed.awl...@sue.nl.invalid> wrote:
>
> Thanks, is there a docs on how to use this script? I see some variables I
> need to pass but not sure what they are.
>
> On Thu, 13 Jun 2024 at 16:03, Pearl d'Silva <pearl.dsi...@shapeblue.com>
> wrote:
>
> > The build-apidoc.sh script:
> > https://github.com/apache/cloudstack/blob/main/tools/apidoc/build-apidoc.sh
> > is responsible for generating the API docs.
> >
> > Regards.
> >
> >
> >
> > ________________________________
> > From: Ahmed Awlaqi <ahmed.awl...@sue.nl.INVALID>
> > Sent: June 13, 2024 9:39 AM
> > To: dev@cloudstack.apache.org <dev@cloudstack.apache.org>
> > Subject: Re: Endpoint response is different than the docs
> >
> > Hi,
> >
> > I will try to submit a PR for it but do you where I can find the code that
> > generates the API docs to test it.
> >
> > On Thu, Jun 13, 2024 at 2:40 PM Pearl d'Silva <pearl.dsi...@shapeblue.com>
> > wrote:
> >
> > > Hi,
> > >
> > > There does seem to be a difference in the API command definition and the
> > > actual response generated. You may either raise an issue at
> > > https://github.com/apache/cloudstack/issues or could also contribute
> > > towards a fix. The issue seems to be at:
> > >
> > >
> > >
> > https://github.com/apache/cloudstack/blob/main/api/src/main/java/org/apache/cloudstack/api/command/admin/storage/heuristics/RemoveSecondaryStorageSelectorCmd.java#L30
> > > vs
> > >
> > >
> > https://github.com/apache/cloudstack/blob/main/api/src/main/java/org/apache/cloudstack/api/command/admin/storage/heuristics/RemoveSecondaryStorageSelectorCmd.java#L43
> > >
> > >
> > > Thanks,
> > > Pearl
> > >
> > >
> > >
> > >
> > > ________________________________
> > > From: Ahmed Awlaqi <ahmed.awl...@sue.nl.INVALID>
> > > Sent: June 13, 2024 8:04 AM
> > > To: dev@cloudstack.apache.org <dev@cloudstack.apache.org>
> > > Subject: Endpoint response is different than the docs
> > >
> > > Hi,
> > >
> > > I faced a problem where the endpoint response is different from what is
> > > written in the docs the endpoint is `removeSecondaryStorageSelector` in
> > > here
> > >
> > >
> > https://cloudstack.apache.org/api/apidocs-4.19/apis/removeSecondaryStorageSelector.html
> > > we see the response tags but actually non of them are actually returned
> > and
> > > I get `{"success":true}`.
> > >
> > > --
> > >  <https://www.multistax.com>
> > >
> > > --
> > > The information in this message is confidential, and only intended for
> > the
> > > addressee(s). If you are not the person to whom this message is
> > addressed,
> > > you are hereby notified that any disclosure, reproduction, distribution
> > or
> > > use of this message is strictly prohibited. If you received this in
> > error,
> > > please inform the sender and delete the message without copying or
> > opening
> > > it.
> > >
> >
> > --
> >  <https://www.multistax.com>
> >
> > --
> > The information in this message is confidential, and only intended for the
> > addressee(s). If you are not the person to whom this message is addressed,
> > you are hereby notified that any disclosure, reproduction, distribution or
> > use of this message is strictly prohibited. If you received this in error,
> > please inform the sender and delete the message without copying or opening
> > it.
> >
>
> --
>  <https://www.multistax.com>
>
> --
> The information in this message is confidential, and only intended for the
> addressee(s). If you are not the person to whom this message is addressed,
> you are hereby notified that any disclosure, reproduction, distribution or
> use of this message is strictly prohibited. If you received this in error,
> please inform the sender and delete the message without copying or opening
> it.

Reply via email to