vCloud API Programming Guide
74 VMware, Inc.
Youcanreconfigureavirtualmachine(Vmelement)bymakingchangestoanyofthefollowingsections:
VirtualHardwareSection
OperatingSystemSection
NetworkConnectionSection
GuestCustomizationSection
Modifiedsectionsmustcontainallrequiredelements,evenifyouarenotchangingtheirvalues.Some
elementsinsomesectionsareread‐only.Seetheschemareferencesfordetails.
Table 5-3. Summary of Virtual Machine Reconfiguration Requests
Operation Request Request Body Response
RetrievetheNetworkConnection
ofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
networkConnectionSection/
None NetworkConnectionSection
ModifytheNetworkConnection
ofaVirtualMachine
PUTAPI‐URL/vApp/vm‐id/
networkConnectionSection/
NetworkConnectionSection Task
RetrievetheGuestCustomization
SectionofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
guestCustomizationSection/
None GuestCustomizationSection
ModifytheGuestCustomization
SectionofaVirtualMachine
PUT
API‐URL/vApp/vm‐id/
guestCustomizationSection/
GuestCustomizationSection Task
RetrievetheOperatingSystem
SectionofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
operatingSystemSection/
None OperatingSystemSection
ModifytheOperatingSystem
SectionofaVirtualMachine
PUTAPI‐URL/vApp/vm‐id/
operatingSystemSection/
OperatingSystemSection Task
RetrievetheVirtualHardware
SectionofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/
None VirtualHardwareSection
ModifytheVirtual
Hardware
SectionofaVirtualMachine
PUTAPI‐URL/vApp/vm‐id/
virtualHardwareSection/
VirtualHardwareSection Task
RetrievetheCPUConfigurationof
aVirtualMac hine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/cpu
None ovf:Item
ModifytheCPUConfigurationof
aVirtualMac hine
PUTAPI‐URL/vApp/vm‐id/
virtualHardwareSection/cpu
ovf:Item Task
RetrievetheMemoryItemfrom
theVirtualHardwareSectionofa
VirtualMachine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/memory
None ovf:Item
ModifytheMemoryItemofthe
VirtualHardwareSectionofa
VirtualMachine
PUTAPI‐URL/vApp/vm‐id/
virtualHardwareSection/memory
ovf:Item Task
RetrieveVirtualDiskItemsfrom
theVirtualHardwareSectionofa
VirtualMachine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/disks
None RasdItemsList
ModifyVirtualDiskItemsofthe
VirtualHardware
Sectionofa
VirtualMachine
PUTAPI‐URL/vApp/vm‐id/
virtualHardwareSection/disks
RasdItemsList Task
RetrieveNetworkCardItems
fromtheVirtualHardwareSection
ofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/
networkCards
None RasdItemsList
ModifyNetworkCardItemsofthe
VirtualHardwareSectionofa
VirtualMachine
PUTAPI‐URL/vApp/vm‐id/
virtualHardwareSection/
networkCards
RasdItemsList Task
RetrieveRemovableMedia
Drive
ItemsfromtheVirtualHardware
SectionofaVirtualMachine
GETAPI‐URL/vApp/vm‐id/
virtualHardwareSection/media
None RasdItemsList