GetVmGuestToolsInfo

Obtains information about the GuestTools of a VM instance. For example,
GetVmGuestToolsInfo uuid=5ecc83bf3f5033b9b78b4f9406c01f8f

Parameters

Name Description Optional Valid Value Starting Version
uuid The resource UUID. 3.7.0
userTags The user tags. For more information, see CreateUserTag. Yes 3.7.0
systemTags The system tags. For more information, see CreateSystemTag. Yes 3.7.0
timeout Yes
Note:
  • ZStack Cloud records the version of the GuestTools ISO installed in the VM instance, compares the ISO version with that of the host, and then decides whether to upgrade the GuestTools ISO. Note that you can add the GuestTools option to SystemTags.
    • Format of the GuestTools option: GuestTools::TOOLS_VERSION. Here, the initial value of TOOLS_VERSION is 1.0.0. This value will change as the version of GuestTools is upgraded.
    • Example: GuestTools::1.0.0
    • Note: This API is used to obtain the version and running status of the GuestTools installed in the VM instance. If the requested information is returned but the VM instance does not have a GuestTools tag, then a GuestTools tag will be created. If the requested information is returned but the returned GuestTools information is different from the current GuestTools tag value of the VM instance, then the tag will be updated.