Vim Cluster Vsan Vc Stretched Cluster System Query Shared Witness Compatibility
Query whether a given host could be used as shared witness for a group of specified ROBO clusters.
Result data would contain compatibility check result for both sharedWitnessHost and roboClusters. For sharedWitnessHost, it will check following items. 1) Check whether given host is a witness host. 2) Check whether this witness host has shared witness capability. 3) Check whether clusters count would exceed per shared witness host's limit. For roboClusters, it will check following items. 1) For a vSAN not enabled cluster, check whether it could be a candidate of ROBO cluster (cluster which has 2 hosts). 2) For a vSAN enabled cluster, check whether it is a ROBO cluster (stretched cluster which has 2 hosts). 3) For a ROBO cluster, check whether its component limit exceeds current shared witness host's component count limitation for individual cluster.
Required privileges: System.Read
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 VimClusterVsanVcStretchedClusterSystem/{moId}
.
The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.
"QuerySharedWitnessCompatibilityRequestType Object"
A host entity which would be used as a shared witness host.
A list of ROBO clusters which would use sharedWitnessHost as their witness.
SharedWitnessCompatibilityResult to present compatibility check result of given shared witness host and robo cluster list.
"VSANSharedWitnessCompatibilityResult Object"
Represent whether given shared witness host could be attached to all specified ROBO clusters.
Represent whether each given ROBO cluster could support using target shared witness host as its witness.
VsanFault: If any unexpected runtime fault is met.
NotSupported: If this API is not supported on current platform.
"MethodFault Object"
Fault which is the cause of this fault.
Message which has details about the error Message can also contain a key to message catalog which can be used to generate better localized messages.
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VimClusterVsanVcStretchedClusterSystem/{moId}/QuerySharedWitnessCompatibility