Virtual Machine Provisioning Checker Check Migrate Task
Tests the feasibility of a proposed MigrateVM_Task operation.
Required privileges: System.View
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case VirtualMachineProvisioningChecker/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"vm": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"host": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"pool": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"state": "string",
"testType": [
"string"
]
}
The PowerState type defines a simple set of states for a virtual machine: poweredOn, poweredOff, and suspended.
This type does not model substates, such as when a task is running to change the virtual machine state. If the virtual machine is in a state with a task in progress, it transitions to a new state when the task completes. For example, a virtual machine continues to be in the poweredOn state while a suspend task is running, and changes to the suspended state once the task finishes.
As a consequence of this approach, clients interested in monitoring the status of a virtual machine should typically track the activeTask data object in addition to the powerState object.
Possible values:
poweredOff
: The virtual machine is currently powered off.poweredOn
: The virtual machine is currently powered on.suspended
: The virtual machine is currently suspended.
The set of tests to run. If this argument is not set, all tests will be run. See CheckTestTypeEnum for possible values.
OK
{
"_typeName": "string",
"type": "string",
"value": "string"
}
InvalidArgument: if the target host(s) and target pool for a migration are not associated with the same compute resource, or if the host parameter is left unset when the target pool is associated with a non-DRS cluster.
InvalidPowerState: if the state argument is set and at least one of the specified virtual machines is not in that power state.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}