Service Instance Validate Migration
Deprecated as of vSphere API 4.0, use VirtualMachineProvisioningChecker instead.
Checks the validity of a set of proposed migrations.
A migration is the act of changing the assigned execution host of a virtual machine, which can result from invoking MigrateVM_Task or RelocateVM_Task.
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 ServiceInstance/{moId}.
The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.
"ValidateMigrationRequestType Object"The set of virtual machines intended for migration.
The power state that the virtual machines must have. If this argument is not set, each virtual machine is evaluated according to its current power state.
The set of tests to run. If this argument is not set, all tests will be run.
The target resource pool for the virtual machines. If the pool parameter is left unset, the target pool for each particular virtual machine's migration will be that virtual machine's current pool. If the virtual machine is a template then either this parameter or the host parameter must be set; additionally if resource tests are requested then this parameter is required.
The target host on which the virtual machines will run. The host parameter may be left unset if the compute resource associated with the target pool represents a stand-alone host or a DRS-enabled cluster. In the former case the stand-alone host is used as the target host. In the latter case, each connected host in the cluster that is not in maintenance mode is tested as a target host. If the virtual machine is a template then either this parameter or the pool parameter must be set.
A set of events that describe the warnings or errors that would apply if the proposed set of migrations were executed.
[
"Event Object"
]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.
NoActiveHostInCluster: if a target host is not specified and a cluster associated with a target pool does not contain at least one potential target host. A host must be connected and not in maintenance mode in order to be considered as a potential target host.
"InvalidState Object" curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/ServiceInstance/{moId}/ValidateMigration