Unsupported content This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Update Virtual Machine Memory operation


The Update Virtual Machine Memory operation updates the memory resources of a virtual machine (VM) created on the Microsoft Hyper-V server. This topic illustrates the actor adapter request and response and describes the elements used in the request.

Warning

The Update Virtual Machine Memory operation works only when the state of the VM is "Stopped".

The following table describes the elements for the adapter request:

 Adapter request elements for the Update Virtual Machine Memory operation

The following figure shows a sample <items> XML element for the Update Virtual Machine Memory operation.

Sample <items> XML element for the Update Virtual Machine Memory operation



<items>
 <item>
   <target>
<host>10.111.8.222</host>
<user-name>administrator</user-name>
       <password   encryption-type="Base64">pwd</password>   
<timeout-secs>120</timeout-secs>
   </target>
   <vm>RHEL5</vm>
   <memory>1024</memory>
 </item>
 <item>
   <target>
<host>pw-mmm-abc-dv00</host>
<user-name>administrator</user-name>
       <password>pwd</password>   
   </target>
   <vm>VM6</vm>
   <memory>512</memory>
 </item>
 <item>
   <vm>VM5</vm>
   <memory>1024</memory>
 </item>
 <item>
   <target>Config1</target>
   <vm>VM45</vm>
   <memory>512</memory>
 </item>
</items>

The following figure shows a sample adapter request for the Update Virtual Machine Memory operation:

Sample adapter request for the Update Virtual Machine Memory operation



<ms-hyperv-request>
   <operation-name>update-vm-memory</operation-name>
   <arguments>
     <target>
       <host>10.111.8.222</host>
       <user-name>administrator</user-name>
       <password encryption-type="Base64">pwd</password>
       <timeout-secs>120</timeout-secs>
     </target>
     <vm>RHEL5</vm>
     <memory>1024</memory>
   </arguments>
   <arguments>
     <target>
       <host>pw-mmm-abc-dv00</host>
       <user-name>administrator</user-name>
       <password>pwd</password>
     </target>
     <vm>VM6</vm>
     <memory>512</memory>
   </arguments>
   <arguments>
     <vm>VM5</vm>
     <memory>1024</memory>
   </arguments>
   <arguments>
     <target>Config1</target>
     <vm>VM45</vm>
     <memory>512</memory>
   </arguments>
 </ms-hyperv-request> 

The following figure shows a sample adapter response for the Update Virtual Machine Memory operation:

Sample adapter response for the Update Virtual Machine Memory operation



<ms-hyperv-response>
 <metadata>
   <status>success</status>
   <response-count>4</response-count>
 </metadata>
 <responses>
   <UpdateVirtualMachineMemoryResponse>
     <metadata>
       <target>10.111.8.222</target>
       <status>success</status>
       <count>1</count>
     </metadata>
     <items>
       <item>
         <vm-element-name>RHEL5</vm-element-name>
         <genus>2</genus>
         <class>Msvm_MemorySettingData</class>
         <superclass>CIM_ResourceAllocationSettingData</superclass>
         <dynasty>CIM_ManagedElement</dynasty>
         <relpath>Msvm_MemorySettingData.InstanceID="Microsoft:9C4BE436-1</relpath>
         <property-count>25</property-count>
         <derivation>{CIM_ResourceAllocationSettingData, CIM_SettingData, CI</derivation>
         <server>PW-PUN-RDS-DV01</server>
         <namespace>root\virtualization</namespace>
         <path>\\PW-PUN-RDS-DV01\root\virtualization:Msvm_MemorySettin</path>
         <address></address>
         <allocation-units>MB</allocation-units>
         <automatic-allocation>True</automatic-allocation>
         <automatic-deallocation>True</automatic-deallocation>
         <caption>Memory</caption>
         <connection></connection>
         <consumer-visibility></consumer-visibility>
         <description>Settings for Microsoft Virtual Machine Memory.</description>
         <device-i-d></device-i-d>
         <device-i-d-format></device-i-d-format>
         <dynamic-memory-enabled></dynamic-memory-enabled>
         <element-name>Memory</element-name>
         <host-resource></host-resource>
         <instance-i-d>Microsoft:9C4BE436-1EAE-4210-AD25-EB94E14E1377\4764334d</instance-i-d>
         <is-virtualized>True</is-virtualized>
         <limit>1024</limit>
         <mapping-behavior></mapping-behavior>
         <other-resource-type></other-resource-type>
         <parent></parent>
         <pool-i-d>15129609-B465-4916-AA13-0CF4B109ADB0</pool-i-d>
         <reservation>1024</reservation>
         <resource-sub-type>Microsoft Virtual Machine Memory</resource-sub-type>
         <resource-type>4</resource-type>
         <virtual-quantity>1024</virtual-quantity>
         <weight>0</weight>
       </item>
     </items>
   </UpdateVirtualMachineMemoryResponse>
   <UpdateVirtualMachineMemoryResponse>
     <metadata>
       <target>pw-pun-rds-dv01</target>
       <status>success</status>
       <count>1</count>
     </metadata>
     <items>
       <item>
         <vm-element-name>VM6</vm-element-name>
         <genus>2</genus>
         <class>Msvm_MemorySettingData</class>
         <superclass>CIM_ResourceAllocationSettingData</superclass>
         <dynasty>CIM_ManagedElement</dynasty>
         <relpath>Msvm_MemorySettingData.InstanceID="Microsoft:37D53DC3-F</relpath>
         <property-count>25</property-count>
         <derivation>{CIM_ResourceAllocationSettingData, CIM_SettingData, CI</derivation>
         <server>PW-PUN-RDS-DV01</server>
         <namespace>root\virtualization</namespace>
         <path>\\PW-PUN-RDS-DV01\root\virtualization:Msvm_MemorySettin</path>
         <address></address>
         <allocation-units>MB</allocation-units>
         <automatic-allocation>True</automatic-allocation>
         <automatic-deallocation>True</automatic-deallocation>
         <caption>Memory</caption>
         <connection></connection>
         <consumer-visibility></consumer-visibility>
         <description>Settings for Microsoft Virtual Machine Memory.</description>
         <device-i-d></device-i-d>
         <device-i-d-format></device-i-d-format>
         <dynamic-memory-enabled></dynamic-memory-enabled>
         <element-name>Memory</element-name>
         <host-resource></host-resource>
         <instance-i-d>Microsoft:37D53DC3-FF03-49DA-A973-B5EDE7A90F44\4764334d</instance-i-d>
         <is-virtualized>True</is-virtualized>
         <limit>512</limit>
         <mapping-behavior></mapping-behavior>
         <other-resource-type></other-resource-type>
         <parent></parent>
         <pool-i-d>15129609-B465-4916-AA13-0CF4B109ADB0</pool-i-d>
         <reservation>512</reservation>
         <resource-sub-type>Microsoft Virtual Machine Memory</resource-sub-type>
         <resource-type>4</resource-type>
         <virtual-quantity>512</virtual-quantity>
         <weight>0</weight>
       </item>
     </items>
   </UpdateVirtualMachineMemoryResponse>
   <UpdateVirtualMachineMemoryResponse>
     <metadata>
       <target>10.111.8.222</target>
       <status>success</status>
       <count>1</count>
     </metadata>
     <items>
       <item>
         <vm-element-name>VM5</vm-element-name>
         <genus>2</genus>
         <class>Msvm_MemorySettingData</class>
         <superclass>CIM_ResourceAllocationSettingData</superclass>
         <dynasty>CIM_ManagedElement</dynasty>
         <relpath>Msvm_MemorySettingData.InstanceID="Microsoft:26D3A022-D</relpath>
         <property-count>25</property-count>
         <derivation>{CIM_ResourceAllocationSettingData, CIM_SettingData, CI</derivation>
         <server>PW-PUN-RDS-DV01</server>
         <namespace>root\virtualization</namespace>
         <path>\\PW-PUN-RDS-DV01\root\virtualization:Msvm_MemorySettin</path>
         <address></address>
         <allocation-units>MB</allocation-units>
         <automatic-allocation>True</automatic-allocation>
         <automatic-deallocation>True</automatic-deallocation>
         <caption>Memory</caption>
         <connection></connection>
         <consumer-visibility></consumer-visibility>
         <description>Settings for Microsoft Virtual Machine Memory.</description>
         <device-i-d></device-i-d>
         <device-i-d-format></device-i-d-format>
         <dynamic-memory-enabled></dynamic-memory-enabled>
         <element-name>Memory</element-name>
         <host-resource></host-resource>
         <instance-i-d>Microsoft:26D3A022-D84E-4F2B-842B-8C173EFFD865\4764334d</instance-i-d>
         <is-virtualized>True</is-virtualized>
         <limit>1024</limit>
         <mapping-behavior></mapping-behavior>
         <other-resource-type></other-resource-type>
         <parent></parent>
         <pool-i-d>15129609-B465-4916-AA13-0CF4B109ADB0</pool-i-d>
         <reservation>1024</reservation>
         <resource-sub-type>Microsoft Virtual Machine Memory</resource-sub-type>
         <resource-type>4</resource-type>
         <virtual-quantity>1024</virtual-quantity>
         <weight>0</weight>
       </item>
     </items>
   </UpdateVirtualMachineMemoryResponse>
   <UpdateVirtualMachineMemoryResponse>
     <metadata>
       <target>pw-pun-rds-dv01</target>
       <status>success</status>
       <count>1</count>
     </metadata>
     <items>
       <item>
         <vm-element-name>VM45</vm-element-name>
         <genus>2</genus>
         <class>Msvm_MemorySettingData</class>
         <superclass>CIM_ResourceAllocationSettingData</superclass>
         <dynasty>CIM_ManagedElement</dynasty>
         <relpath>Msvm_MemorySettingData.InstanceID="Microsoft:8F7A9D52-F</relpath>
         <property-count>25</property-count>
         <derivation>{CIM_ResourceAllocationSettingData, CIM_SettingData, CI</derivation>
         <server>PW-PUN-RDS-DV01</server>
         <namespace>root\virtualization</namespace>
         <path>\\PW-PUN-RDS-DV01\root\virtualization:Msvm_MemorySettin</path>
         <address></address>
         <allocation-units>MB</allocation-units>
         <automatic-allocation>True</automatic-allocation>
         <automatic-deallocation>True</automatic-deallocation>
         <caption>Memory</caption>
         <connection></connection>
         <consumer-visibility></consumer-visibility>
         <description>Settings for Microsoft Virtual Machine Memory.</description>
         <device-i-d></device-i-d>
         <device-i-d-format></device-i-d-format>
         <dynamic-memory-enabled></dynamic-memory-enabled>
         <element-name>Memory</element-name>
         <host-resource></host-resource>
         <instance-i-d>Microsoft:8F7A9D52-F292-4599-95C7-1D559595D9CB\4764334d</instance-i-d>
         <is-virtualized>True</is-virtualized>
         <limit>512</limit>
         <mapping-behavior></mapping-behavior>
         <other-resource-type></other-resource-type>
         <parent></parent>
         <pool-i-d>15129609-B465-4916-AA13-0CF4B109ADB0</pool-i-d>
         <reservation>512</reservation>
         <resource-sub-type>Microsoft Virtual Machine Memory</resource-sub-type>
         <resource-type>4</resource-type>
         <virtual-quantity>512</virtual-quantity>
         <weight>0</weight>
       </item>
     </items>
   </UpdateVirtualMachineMemoryResponse>
 </responses>
</ms-hyperv-response> 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*