Precheck Clusters Configuration Task
This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster. The API will check against the desired image schema whether the desired configuration has added any requirements for the host to be put in maintenance mode or to be rebooted. The API will also invoke plugins provided by the configuration owner to detect if the host needs to be put in maintenance mode or to be rebooted. If any host needs to be put in maintenance mode or rebooted, prechecks will be performed at the cluster and host level. The result will specify the validation errors if the desired configuration is not valid on the host. If valid, the result will specify host impact of the desired configuration, and list the configurations that will change on applying the desired configuration. If host impact is maintenance mode or reboot, precheck results will also be specified in the result. Warning: This operation is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.
The cluster on which to perform precheck. The parameter must be an identifier for the resource type: ClusterComputeResource.
Required session ID, acquired from Create Session API under CIS product
An identifier for the task created by this API invocation will be returned. If the non-async version of the operation returns a value, this id can be used with the CIS Get Task operation to fetch that value. The normal description of this operation’s return value will follow if one exists. This output structure of type com.vmware.esx.settings.clusters.Configuration#ClusterPrecheckResult represents results of the impact analysis and precheck executed on each of the hosts for the desired configuration. If the precheck could not be performed on a host, the com.vmware.esx.settings.clusters.Configuration.ClusterPrecheckResult#hostStatus map will contain the reason.
com.vmware.vapi.std.errors.invalid_argument : If API is called on a cluster that is not managed by desired configuration management platform.
com.vmware.vapi.std.errors.unauthenticated : If the caller is not authenticated.
com.vmware.vapi.std.errors.not_found : If the cluster is not found in the system.
com.vmware.vapi.std.errors.error : The server encountered an unexpected condition which prevented it from fulfilling the request. | com.vmware.vapi.std.errors.timed_out : If the API timed out before completion.
com.vmware.vapi.std.errors.service_unavailable : If the service is not available.
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
PowerCLI Client SDK Example