Update Virtual Machine Processors operation


The Update Virtual Machine Processors operation sets the processor resources allocated to 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 Processors 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 Processors operation

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

Sample <items> XML element for the Update Virtual Machine Processors 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>VM1</vm>
     <vm-guid>1CCBFE38-FF48-424F-9FE2-713293C7105F<vm-guid>
     <cpu-count>2</cpu-count>
     <weight>200</weight>
     <limit>50</limit>
     <reservation>70</reservation>
  </item>
  <item>
     <target>
 <host>pw-mmm-abc-dv00</host>
<user-name>administrator</user-name>
      <password>bmcAdm1n</password>   
     </target>
     <vm>VM5</vm>
     <cpu-count>3</cpu-count>
     <weight>100</weight>
     <limit>20</limit>
     <reservation>30</reservation>
  </item>
  <item>
     <vm>VM45</vm>
     <cpu-count></cpu-count>
     <weight></weight>
     <limit>40</limit>
     <reservation>80</reservation>
  </item>
  <item>
     <target>Config1</target>
     <vm>VM6</vm>
     <cpu-count>4</cpu-count>
     <weight></weight>
     <limit></limit>
     <reservation>60</reservation>
  </item>
</items> 

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

Sample adapter request for the Update Virtual Machine Processors operation



<ms-hyperv-request>
   <operation-name>update-vm-processors</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>VM1</vm>
     <vm-guid>1CCBFE38-FF48-424F-9FE2-713293C7105F</vm-guid>
     <cpu-count>2</cpu-count>
     <weight>200</weight>
     <limit>50</limit>
     <reservation>70</reservation>
   </arguments>
   <arguments>
     <target>
       <host>pw-mmm-abc-dv00</host>
       <user-name>administrator</user-name>
       <password>bmcAdm1n</password>
     </target>
     <vm>VM5</vm>
     <cpu-count>3</cpu-count>
     <weight>100</weight>
     <limit>20</limit>
     <reservation>30</reservation>
   </arguments>
   <arguments>
     <vm>VM45</vm>
     <cpu-count />
     <weight />
     <limit>40</limit>
     <reservation>80</reservation>
   </arguments>
   <arguments>
     <target>Config1</target>
     <vm>VM6</vm>
     <cpu-count>4</cpu-count>
     <weight />
     <limit />
     <reservation>60</reservation>
   </arguments>
 </ms-hyperv-request> 

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

Sample adapter response for the Update Virtual Machine Processors 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-mmm-abc-dv00</server>
         <namespace>root\virtualization</namespace>
         <path>\\pw-mmm-abc-dv00\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-mmm-abc-dv00</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-mmm-abc-dv00</server>
         <namespace>root\virtualization</namespace>
         <path>\\pw-mmm-abc-dv00\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-mmm-abc-dv00</server>
         <namespace>root\virtualization</namespace>
         <path>\\pw-mmm-abc-dv00\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-mmm-abc-dv00</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-mmm-abc-dv00</server>
         <namespace>root\virtualization</namespace>
         <path>\\pw-mmm-abc-dv00\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*