VMware VCLOUD API 1.0 - API - Enable or Disable a Host; Repair a Host; Unprepare a Host

vCloud API Programming Guide
126 VMware, Inc.
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... operation="Preparing Host (1)" ...>
...
</Task>
Unprepare a Host
UnprepareahosttomakeitunavailableforuseintheCloudDirectorenvironment.Asystemadministrator
canunprepareahostbymakingaPOSTrequesttothehost’saction/unprepareURL.Example 7‐12
unpreparesthehostreferencebyhttp://vcloud.example.com/api/v1.0/admin/extension/host/1.
Example 7-12. Unprepare a Host
Request:
POST http://vcloud.example.com/api/v1.0/admin/extension/host/1/action/unprepare
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... >
...
</Task>
Enable or Disable a Host
YoucandisableahosttopreventvAppsfromstartinguponthehost.Virtualmachinesthatarealready
runningonthehostarenotaffected.Toperformmaintenanceonahost,migrateallvAppsoffofthehostor
stopallvAppsandthendisablethehost.
Asystemadministrator
canenableordisableahostforuseinavCloudbymakingaPOSTrequesttothehost’s
action/enableoraction/disableURL.Example 7‐13disablesthehostreferencedby
http://vcloud.example.com/api/v1.0/admin/extension/host/1.
Example 7-13. Disable a Host
Request:
POST http://vcloud.example.com/api/v1.0/admin/extension/host/1/action/disable
Response:
204 No Content
Repair a Host
IftheCloudDirectoragentonahostcannotbecontacted,asystemadministratorcantrytorepairthehost
POSTrequesttothehost’saction/repairURL.Example 7‐14upgradesthehostagentforthehostreferenced
byhttp://vcloud.example.com/api/v1.0/admin/extension/host/1.