VMware VCLOUD API 1.0 - API

VMware, Inc. 125
Chapter 7 VMware vSphere Platform Operations
Example 7-10. Get Information About a Host
Request:
GET http://vcloud.example.com/api/v1.0/admin/extension/host/22
Response:
200 OK
Content-Type: application/vnd.vmware.admin.host+xml
...
<vmext:Host xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="10.115.121.14"
href="http://vcloud.example.com/api/v1.0/admin/extension/host/22" ... >
<vcloud:Link rel="disable"
href="http://vcloud.example.com/api/v1.0/admin/extension/host/22/action/disable"/>
<vcloud:Description/>
<vmext:Ready>true</vmext:Ready>
<vmext:Available>true</vmext:Available>
<vmext:Enabled>true</vmext:Enabled>
<vmext:Busy>false</vmext:Busy>
<vmext:EnableHostForHostSpanning>true</vmext:EnableHostForHostSpanning>
<vmext:CpuType>Intel(R) Xeon(R) CPU E5310 @ 1.60GHz</vmext:CpuType>
<vmext:NumOfCpusPackages>2</vmext:NumOfCpusPackages>
<vmext:NumOfCpusLogical>8</vmext:NumOfCpusLogical>
<vmext:CpuTotal>1600</vmext:CpuTotal>
<vmext:MemUsed>0.0</vmext:MemUsed>
<vmext:MemTotal>8187.5546875</vmext:MemTotal>
<vmext:HostOsName>VMware ESXi</vmext:HostOsName>
<vmext:HostOsVersion>4.0.0</vmext:HostOsVersion>
<vmext:VimPropertyPageUrl>
vpxclient://7416E531-05B9-4C1F-854D-97EF7C546CB0::HostSystem:host-20/
</vmext:VimPropertyPageUrl>
<vmext:VmMoRef>host-20</vmext:VmMoRef>
</vmext:Host>
Prepare a Host
WhenyouaddahosttoavSphereclusterthatCloudDirectoruses,youmustpreparethehostbeforea
providervDCcanusethehost’sresources.
Youcannotprepareahostthatisinlockdownmode.Afteryouprepareahost,youcanenablelockdownmode.
Asystemadministratorcanprepare
ahostbymakingaPOSTrequesttothehost’saction/prepareURLand
supplyingaPrepareHostParamsrequestbodythatincludestheusernameandpasswordofahost
administrator,asshowninExample 7‐11.
Example 7-11. Prepare a Host
Request:
POST http://vcloud.example.com/api/v1.0/admin/extension/host/1/action/prepare
Content-Type: application/vnd.vmware.admin.prepareHostParams+xml
...
<vmext:PrepareHostParams xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
xmlns:vcloud="http://www.vmware.com/vcloud/v1"
type="application/vnd.vmware.admin.vmwprovidervdc+xml">
<vmext:Username>Administrator</vmext:Username>
<vmext:Password>Pa55w0rd</vmext:Password>
</vmext:PrepareHostParams>