VMware VCLOUD API 1.0 - API

VMware, Inc. 107
Chapter 6 Administrative Operations
<ComputeCapacity>
<Cpu>
<Units>MHz</Units>
<Allocated>4096</Allocated>
<Limit>4096</Limit>
</Cpu>
...
</ComputeCapacity>
...
</AdminVdc>
Enable or Disable a vDC
AnadministratorcanusetheenableordisableactionlinksinanAdminVdcbodytoenableordisableavDC.
TherequestandresponsearesimilartothoseshowninExample 6‐7onpage 98.Theenablementstateofthe
vDCisshowninitsIsEnabledelement.
Remove a vDC
BeforeyoucanremoveavDC,youmustdisableit.AfterthevDChasbeendisabled,itsrepresentationincludes
arel="remove"link.AnadministratorcanmakeaDELETErequesttothatlinktoremoveavDCfroman
organization.
Example 6-18. Remove a vDC
Request:
DELETE http://vcloud.example.com/api/v1.0/admin/vdc/6
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... operation="Deleted Virtual Datacenter (6)" ...>
...
</Task>
Catalog Administration
Anewlycreatedorganizationhasnocatalogsinit.Anorganizationadministratormustcreatethemand
specifytheirscopebeforeitemscanbecatalogued.Youdonothavetobeanadministratortoaddorremove
CatalogItemelements.See“CatalogingvAppTemplatesandMediaImages”onpage 54.
Create a Catalog
EveryorganizationhasanaddURLforcatalogs.AnadministratorcancreateacatalogbyPOSTingaCatalog
bodytothisURL.Example 6‐19doesthis,usingtheURLinthisLinkshowninExample 6‐3.
<Link rel="add" type="application/vnd.vmware.admin.catalog+xml"
href="http://vcloud.example.com/api/v1.0/admin/org/26/catalogs"/>
Theresponseechoestherequest,andincludestheseadditionscreatedbytheserver.
 AURL(thevalueofthehrefattributeoftheresponsebody)thatreferencesthenewcatalog.
 Linksthataclientcanusetorequestoperationslikeaddanitemtothecatalog,editcatalogproperties,or
removethecatalog.
 Alinktothealternate(user)viewofthiscatalog
 AnemptyCatalogItemselement