5.5

Procedure
1 Retrieve the hard disk configuration from the virtual machine.
Make a GET request to the virtual machine's virtualHardwareSection/disks link.
GET https://vcloud.example.com/api/vApp/vm-4/virtualHardwareSection/disks
The response to this kind of request is a RasdItemsList element that contains an Item element for each
of the virtual machine's hard disks and hard disk controllers, as shown in “Example: Retrieve the Hard
Disks and Controllers in a Virtual Machine,” on page 142.
2 Modify the retrieved section.
Modified sections must contain all required elements, even if you are not changing their values.
Because optional elements revert to default values if they are omitted or empty, it is a best practice to
include optional elements in updates. Link elements and href attributes from responses do not need to
be included in modified sections. Some elements and attributes might be read-only. See the schema
reference for details.
You cannot modify the values of the busType and busSubType attributes after you create a new disk.
When creating a new disk, be sure to set the values of busType and busSubType to a valid combination.
Table 5‑5. Valid Combinations of busType and busSubType
busType busSubType Controller
5 null IDE controller
6
buslogic
BusLogic Parallel SCSI controller
6
lsilogic
LSI Logic Parallel SCSI controller
6
lsilogicsas
LSI Logic SAS SCSI controller
6
VirtualSCSI
Paravirtual SCSI controller
20
vmware.sata.ahci
SATA controller (hardware version 10 and later)
3 Update the section with your modifications.
Find the Link element in the section where rel="edit". Make a PUT request to the URL in that link's
href attribute value, and supply the modified section as the request body.
The response to this request is a Task element that tracks the update operation. When the task is
complete, the section is updated.
The modified section replaces the contents of the original section. For some section types, modifications take
effect immediately. For others, modifications take effect only after a power or deployment state change.
Example: Modify the Hard Disk Configuration of a Virtual Machine
The following request increases the capacity of the hard disk from 1GB to 10GB by changing the
vcloud:capacity value of the Item that defines the disk. The capacity is raised from 1024 to 10240. The
request body includes the entire RasdItemsList returned by the request shown in Step 1, even though only
one element is changed. Link elements from a response are ignored if you include them in a request, so they
are omitted in this example.
Request:
PUT https://vcloud.example.com/api/vApp/vm-4/virtualHardwareSection/disks
Content-Type: application/vnd.vmware.vcloud.rasditemslist+xml
...
<?xml version="1.0" encoding="UTF-8"?>
<RasdItemsList
xmlns="http://www.vmware.com/vcloud/v1.5"
vCloud API Programming Guide
144 VMware, Inc.