VMware VCLOUD API 1.0 - API

vCloud API Programming Guide
22 VMware, Inc.
<Org .../>
<Org .../>
</OrgList>
Theresponseincludesanauthenticationtokensuppliedinthe x-vcloud-authorizationheader,andalist
oftheorganizationstowhichtheauthenticateduserhasaccess.EachOrghasaURL(initshrefattribute
value)thattheclientcanusetogetmoreinformationaboutobjectsthattheorganizationcontains.Formore
informationaboutauthentication,see“Authentication”onpage 18.
Browsing an Organization
YoucanuseanHTTPGETrequestandoneoftheOrgURLsreturnedbytheloginrequesttodiscoverthe
contentsofanorganization,asshowninExample 2‐2.(Foramorecompleteversionofthisexample,see
Example 3‐1onpage 34.)
Example 2-2. List the Contents of an Organization
Request:
GET http://vcloud.example.com/api/v1.0/org/5
Response:
200 OK
Content-Type: application/vnd.vmware.vcloud.org+xml
...
<Org name="ExampleOrg" type="application/vnd.vmware.vcloud.org+xml"
href="http://vcloud.example.com/api/v1.0/org/5" ... >
<Link ... />
<Link rel="down" type="application/vnd.vmware.vcloud.catalog+xml"
href="http://vcloud.example.com/api/v1.0/catalog/32" name="MainCatalog"/>
<Link ... />
<Link rel="down" type="application/vnd.vmware.vcloud.vdc+xml"
href="http://vcloud.example.com/api/v1.0/vdc/5" name="ExampleVdc01"/>
<Link ... />
<Link rel="down" type="application/vnd.vmware.vcloud.network+xml"
href="http://vcloud.example.com/api/v1.0/network/14" name="IsolatedOrgNet"/>
<Link rel="down" type="application/vnd.vmware.vcloud.network+xml"
href="http://vcloud.example.com/api/v1.0/network/54" name="Internet"/>
<Description>Example Corp’s Primary Organization</Description>
</Org>
Linksintheresponsewhoserelattributehasavalueofdownarereferencestoobjectsthattheorganization
contains.Example 2‐2showsthesubsetofthoseitemsthatyouwillneedforthisexercise:
 AcatalognamedMainCatalog,atURLhttp://vcloud.example.com/api/v1.0/catalog/32,whereyoucan
lookforvApptemplates.
 AvDCnamedExampleVdc01,atURLhttp://vcloud.example.com/api/v1.0/vdc/5,whereyoucandeploy
thevApp.
 Twonetworks:onenamedInternet,atURLhttp://vcloud.example.com/api/v1.0/network/54,andone
namedIsolatedOrgNet,atURLhttp://vcloud.example.com/api/v1.0/network/14.Youcanconnect
connectthevApptoeitherofthesenetworks.
N
OTEThisexample,likeotherexamplesinthisguide,omitscertainrequiredHTTPheadersandothercontent
sothatitcanprovideaconcise,readablesubsetofanactualrequestandresponse.Formoreinformation,see
“A b o u t theExamples”onpage 19.