VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 84 / 212

vCloud API Programming Guide
84 VMware, Inc.
Shut Down a vApp or Virtual Machine
A shutdown request to a vApp URL shuts down all of the virtual machines in the vApp, as specified in its
ovf:StartupSection element.
A shutdown request to a virtual machine URL shuts down the specified virtual machine.
Example 5-26. Shut Down a vApp or Virtual Machine
Request to shut down a vApp:
POST http://vcloud.example.com/api/v1.0/vApp/vapp-7/power/action/shutdown
Request to shut down a Vm:
POST http://vcloud.example.com/api/v1.0/vApp/vm-5/power/action/shutdown
Response:
204 No Content
Reboot a vApp or Virtual Machine
A reboot request to a vApp URL reboots all of the virtual machines in the vApp, as specified in its
ovf:StartupSection element.
A reboot request to a virtual machine URL reboots the specified virtual machine.
Example 5-27. Reboot a vApp or Virtual Machine
Request to reboot a vApp:
POST http://vcloud.example.com/api/v1.0/vApp/vapp-7/power/action/reboot
Request to reboot a Vm:
POST http://vcloud.example.com/api/v1.0/vApp/vm-5/power/action/reboot
Response:
204 No Content
N
OTE
Because this request sends a signal to the guest OS, the vCloud API cannot track the progress or verify
the result of the requested operation.
N
OTE
Because this request sends a signal to the guest OS, the vCloud API cannot track the progress or verify
the result of the requested operation.