Vm reconfiguration requests retrieve or update modifiable sections of a virtual machine (Vm object).

API-URL is a URL of the form https://vcloud.example.com/api.

id is a unique identifier in the form of a UUID, as defined by RFC 4122.

Important

Request URLs are always available in Link elements contained by the representation of the object on which they operate. URL forms shown here are for reference purposes only. Although URLs have a well-known syntax and a well-understood interpretation, a client should treat vCloud API request URLs as opaque strings. The rules that govern how the server constructs these strings might change in future releases.

This summary may not cover all requests in this category. For the complete list of requests, along with detailed information about input and output types, see the Operations lists in the schema reference.

Summary of Vm Reconfiguration Requests

Operation

Request

Request Body

Response

Retrieve the NetworkConnectionSection of a virtual machine

GET API-URL/vApp/vm-id/ networkConnectionSection/

None

NetworkConnectionSection

Update the NetworkConnectionSection of a virtual machine

PUT API-URL/vApp/vm-id/ networkConnectionSection/

NetworkConnectionSection

Task

Retrieve the GuestCustomizationSection of a virtual machine

GET API-URL/vApp/vm-id/ guestCustomizationSection/

None

GuestCustomizationSectio

Update the GuestCustomizationSection of a virtual machine

PUT API-URL/vApp/vm-id/ guestCustomizationSection/

GuestCustomizationSectio

Task

Retrieve the OperatingSystemSection of a virtual machine

GET API-URL/vApp/vm-id/ operatingSystemSection/

None

OperatingSystemSection

Update the OperatingSystemSection of a virtual machine

PUT API-URL/vApp/vm-id/ operatingSystemSection/

OperatingSystemSection

Task

Retrieve the VirtualHardwareSection of a virtual machine

GET API-URL/vApp/vm-id/ virtualHardwareSection/

None

VirtualHardwareSection

Update the VirtualHardwareSection of a virtual machine

PUT API-URL/vApp/vm-id/ virtualHardwareSection/

VirtualHardwareSection

Task

Retrieve the CPU configuration of a virtual machine

GET API-URL/vApp/vm-id/ virtualHardwareSection/ cpu

None

ovf:Item

Update the CPU configuration of a virtual machine

PUT API-URL/vApp/vm-id/ virtualHardwareSection/ cpu

ovf:Item

Task

Retrieve the memory item from the VirtualHardwareSection of a virtual machine

GET API-URL/vApp/vm-id/ virtualHardwareSection/ memory

None

ovf:Item

Update the memory item in the VirtualHardwareSection of a virtual machine

PUT API-URL/vApp/vm-id/ virtualHardwareSection/ memory

ovf:Item

Task

Retrieve virtual disk items from the VirtualHardwareSection of a virtual machine

GET API-URL/vApp/vm-id/ virtualHardwareSection/ disks

None

RasdItemsList

Update virtual disk items in the VirtualHardwareSection of a virtual machine

PUT API-URL/vApp/vm-id/ virtualHardwareSection/ disks

RasdItemsList

Task

Retrieve network card items from the VirtualHardwareSection of a virtual machine

GET API-URL/vApp/vm-id/ virtualHardwareSection/ networkCards

None

RasdItemsList

Update network card items in the VirtualHardwareSection of a virtual machine

PUT API-URL/vApp/vm-id/ virtualHardwareSection/ networkCards

RasdItemsList

Task

Update the name, Description, and any or all of VirtualHardwareSection, OperatingSystemSection, NetworkConnectionSection, GuestCustomizationSection of a virtual machine. [NEW]

POST API-URL/vApp/vm-id/ action/reconfigureVm

Vm

Task