VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 126 / 212

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.