UpdateVmInstance

Updates information about a VM instance. For example,
UpdateVmInstance uuid=7c4162e8d32d4bea8f7e799024c6b735 name=new-vm

Parameters

Name Description Optional Valid Value Starting Version
uuid The VM instance UUID. 0.6
name The VM instance name. Yes 0.6
description The detailed description of the VM instance. Yes 0.6
state The state of the VM instance.
  • Generally, the state of a VM instance cannot be updated directly. Otherwise, ZStack Cloud might misjudge the state of the VM instance.
  • This parameter can be used only when the actual state of the VM instance is inconsistent with the state recorded by ZStack Cloud, and the synchronization mechanism of ZStack Cloud has expired (which is us usually a bug).
  • The administrator must fully understand the consequences of using this parameter.
 Yes
  • Stopped
  • Running
 0.6
defaultL3NetworkUuid The UUID of the default L3 network. Yes 0.6
platform The platform type of the VM instance. Yes
  • Linux
  • Windows
  • Windows Virtio
  • Other
  • Paravirtualization
 0.6
cpuNum
  • The CPU count of the VM instance. You must stop or enable the VM instance for the setting of this parameter to take effect.
  • The VM instance that is created when NUMA is set to true in global settings can be adjusted.
 Yes 0.6
memorySize
  • The memory size of the VM instance. You must stop or enable the VM instance for the setting of this parameter to take effect.
  • The VM instance that is created when NUMA is set to true in global settings can be adjusted.
 Yes 0.6
userTags The user tags. For more information, see CreateUserTag. The resource type is VmInstanceVO. Yes 0.6
guestOsType Yes 4.1.0
systemTags The system tags. For more information, see CreateSystemTag. The resource type is VmInstanceVO. Yes 0.6
timeout Yes