PUT /vApp/{id}/virtualHardwareSection

Operation:

PUT /vApp/{id}/virtualHardwareSection

Description:

Update the virtual hardware section of a VM.

This operation updates the entire VirtualHardwareSection of a VM. You can also update many RASD item elements of a VirtualHardwareSection individually, or as groups of related items.

Since:

0.9

Input parameters

ovf:VirtualHardwareSection_Type

Consume media type(s):

application/vnd.vmware.vcloud.virtualHardwareSection+xml

Input type:

VirtualHardwareSection_Type

Output parameters

TaskType

This operation is asynchronous and returns a task that you can monitor to track the progress of the request.

Produce media type(s):

application/vnd.vmware.vcloud.task+xml

Output type:

TaskType

Examples

Request

HTTP 1.1
PUT /api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/

Headers:
Content-Length: 7658
Content-Type: application/vnd.vmware.vcloud.virtualHardwareSection+xml; charset=ISO-8859-1
x-vcloud-authorization: uJ13vBx80VGzZ0KcClBqxHNDJr3QI0K5KaQ0YKn2YZ0=

Body:

<?xml version="1.0" encoding="UTF-8"?><ovf:VirtualHardwareSection
    xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1"
    xmlns:rasd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData"
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmw="http://www.vmware.com/schema/ovf"
    xmlns:vssd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    ovf:transport=""
    vcloud:href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/"
    vcloud:type="application/vnd.vmware.vcloud.virtualHardwareSection+xml">
    <ovf:Info>Virtual hardware requirements</ovf:Info>
    <ovf:System>
        <vssd:ElementName>Virtual Hardware Family</vssd:ElementName>
        <vssd:InstanceID>0</vssd:InstanceID>
        <vssd:VirtualSystemIdentifier>importedVapp</vssd:VirtualSystemIdentifier>
        <vssd:VirtualSystemType>vmx-08</vssd:VirtualSystemType>
    </ovf:System>
    <ovf:Item>
        <rasd:Address>00:50:56:8d:7f:21</rasd:Address>
        <rasd:AddressOnParent>0</rasd:AddressOnParent>
        <rasd:AutomaticAllocation>false</rasd:AutomaticAllocation>
        <rasd:Connection
            vcloud:ipAddressingMode="DHCP"
            vcloud:primaryNetworkConnection="true">VM Network</rasd:Connection>
        <rasd:Description>E1000 ethernet adapter on "VM Network"</rasd:Description>
        <rasd:ElementName>Network adapter 0</rasd:ElementName>
        <rasd:InstanceID>1</rasd:InstanceID>
        <rasd:ResourceSubType>E1000</rasd:ResourceSubType>
        <rasd:ResourceType>10</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item>
        <rasd:Address>0</rasd:Address>
        <rasd:Description>SCSI Controller</rasd:Description>
        <rasd:ElementName>SCSI Controller 0</rasd:ElementName>
        <rasd:InstanceID>2</rasd:InstanceID>
        <rasd:ResourceSubType>lsilogicsas</rasd:ResourceSubType>
        <rasd:ResourceType>6</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item>
        <rasd:AddressOnParent>0</rasd:AddressOnParent>
        <rasd:Description>Hard disk</rasd:Description>
        <rasd:ElementName>Hard disk 1</rasd:ElementName>
        <rasd:HostResource
            vcloud:busSubType="lsilogicsas"
            vcloud:busType="6"
            vcloud:capacity="40"/>
        <rasd:InstanceID>2000</rasd:InstanceID>
        <rasd:Parent>2</rasd:Parent>
        <rasd:ResourceType>17</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item>
        <rasd:Address>0</rasd:Address>
        <rasd:Description>IDE Controller</rasd:Description>
        <rasd:ElementName>IDE Controller 0</rasd:ElementName>
        <rasd:InstanceID>3</rasd:InstanceID>
        <rasd:ResourceType>5</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item>
        <rasd:AddressOnParent>1</rasd:AddressOnParent>
        <rasd:AutomaticAllocation>false</rasd:AutomaticAllocation>
        <rasd:Description>CD/DVD Drive</rasd:Description>
        <rasd:ElementName>CD/DVD Drive 1</rasd:ElementName>
        <rasd:HostResource/>
        <rasd:InstanceID>3002</rasd:InstanceID>
        <rasd:Parent>3</rasd:Parent>
        <rasd:ResourceType>15</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item>
        <rasd:AddressOnParent>0</rasd:AddressOnParent>
        <rasd:AutomaticAllocation>false</rasd:AutomaticAllocation>
        <rasd:Description>Floppy Drive</rasd:Description>
        <rasd:ElementName>Floppy Drive 1</rasd:ElementName>
        <rasd:HostResource/>
        <rasd:InstanceID>8000</rasd:InstanceID>
        <rasd:ResourceType>14</rasd:ResourceType>
    </ovf:Item>
    <ovf:Item
        vcloud:href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/cpu"
        vcloud:type="application/vnd.vmware.vcloud.rasdItem+xml">
        <rasd:AllocationUnits>hertz * 10^6</rasd:AllocationUnits>
        <rasd:Description>Number of Virtual CPUs</rasd:Description>
        <rasd:ElementName>1 virtual CPU(s)</rasd:ElementName>
        <rasd:InstanceID>4</rasd:InstanceID>
        <rasd:Reservation>0</rasd:Reservation>
        <rasd:ResourceType>3</rasd:ResourceType>
        <rasd:VirtualQuantity>1</rasd:VirtualQuantity>
        <rasd:Weight>0</rasd:Weight>
        <vmw:CoresPerSocket
            ovf:required="false">1</vmw:CoresPerSocket>
        <vcloud:Link
            href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/cpu"
            rel="edit"
            type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    </ovf:Item>
    <ovf:Item
        vcloud:href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/memory"
        vcloud:type="application/vnd.vmware.vcloud.rasdItem+xml">
        <rasd:AllocationUnits>byte * 2^20</rasd:AllocationUnits>
        <rasd:Description>Memory Size</rasd:Description>
        <rasd:ElementName>4096 MB of memory</rasd:ElementName>
        <rasd:InstanceID>5</rasd:InstanceID>
        <rasd:Reservation>0</rasd:Reservation>
        <rasd:ResourceType>4</rasd:ResourceType>
        <rasd:VirtualQuantity>4096</rasd:VirtualQuantity>
        <rasd:Weight>0</rasd:Weight>
        <vcloud:Link
            href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/memory"
            rel="edit"
            type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    </ovf:Item>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/"
        rel="edit"
        type="application/vnd.vmware.vcloud.virtualHardwareSection+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/cpu"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/cpu"
        rel="edit"
        type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/memory"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/memory"
        rel="edit"
        type="application/vnd.vmware.vcloud.rasdItem+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/disks"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/disks"
        rel="edit"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/media"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/networkCards"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/networkCards"
        rel="edit"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/serialPorts"
        rel="down"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/virtualHardwareSection/serialPorts"
        rel="edit"
        type="application/vnd.vmware.vcloud.rasdItemsList+xml"/>
</ovf:VirtualHardwareSection>

Response

HTTP/1.1 202 Accepted

Headers:
Content-Length: 1338
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/f4701cd0-76ff-4be6-abf1-597158d73f95
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><Task
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    cancelRequested="false"
    expiryTime="2013-05-15T13:18:04.955+03:00"
    href="https://vcloud.example.com/api/task/f4701cd0-76ff-4be6-abf1-597158d73f95"
    id="urn:vcloud:task:f4701cd0-76ff-4be6-abf1-597158d73f95"
    name="task"
    operation="Updating Virtual Machine importedVapp(89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4)"
    operationName="vappUpdateVm"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-14T13:18:04.955+02:00"
    status="running"
    type="application/vnd.vmware.vcloud.task+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Link
        href="https://vcloud.example.com/api/task/f4701cd0-76ff-4be6-abf1-597158d73f95/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4"
        name="importedVapp"
        type="application/vnd.vmware.vcloud.vm+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="system"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
        name="Default"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Details/>
</Task>