vApp and Vm elements include a number of action links. You can use these links to operate a vApp or one of its virtual machines by making requests such as power on, suspend, power off, undeploy, and so on.
Only those action links that are valid for the vApp or virtual machine in its current state are returned. For example, if a vApp is instantiated but not deployed, only the links for deploy and remove are returned. For a vApp that is powered on, links for all actions except powerOn are returned. Some requests apply only to vApps, some apply only to virtual machines (Vm objects), and some apply to both.
This operation requires the rights included in the predefined vApp User role or an equivalent set of rights.
1 | Retrieve the XML representation of the vApp to find the action links it contains. GET https://vcloud.example.com/api/vApp/vapp-7 |
2 | POST a request to the URL that implements the desired action. |