vmware / vcd-api-schemas

Contains relevant schemas for developing against the vCloud Director APIs
Other
8 stars 17 forks source link

API Schemas for VCD 9.7 #10

Open driseley opened 5 years ago

driseley commented 5 years ago

As requested in https://github.com/vmware/vcd-api-tools/issues/10 Would it be possible to get the API Schemas for VCD 9.7? Many thanks.

jmoroski commented 5 years ago

Yes, this is on our backlog.

I'll update this issue when we have an ETA on completion.

driseley commented 4 years ago

Hi @jmoroski - is there any update on this?

ccouzens commented 4 years ago

It's not as nice as having them in Git, but they can be downloaded here

https://vdc-download.vmware.com/vmwb-repository/dcr-public/71e12563-bc11-4d64-821d-92d30f8fcfa1/7424bf8e-aec2-44ad-be7d-b98feda7bae0/doc/7424bf8e-aec2-44ad-be7d-b98feda7bae0.zip

The schemas can be found doc/etc inside the zip file.

The zip file is linked from https://code.vmware.com/apis/553/vmware-cloud-director

driseley commented 4 years ago

Thanks for the update - we currently consume them from maven:

<dependency>
    <groupId>com.vmware.vcloud</groupId>
    <artifactId>vcd-api-bindings-java</artifactId>
    <version>9.1.1</version>
</dependency>

I've tried (and struggled) in the past to get from the schemas to something usable in Java - is there any chance of the maven artifact being updated? Or providing some hints as to how they are compiled?

ccouzens commented 4 years ago

I'm not part of VMware.

I've been developing an OpenAPI spec (ie Swagger 3.0) for the old vCloud API.

https://github.com/ccouzens/vcloud-rest-openapi

Here's the Spec for vCloud 9.7.

I know it still has some rough edges, but I think for some use cases it's very helpful.

You can use this to generate a Java client. Let me know if this helps 🙂