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 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*