Vim Cluster Vsan Vc Stretched Cluster System VSAN Vc Get Witness Hosts

Vim Cluster Vsan Vc Stretched Cluster System VSAN Vc Get Witness Hosts

Query witness host configuration of specified cluster.

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VimClusterVsanVcStretchedClusterSystem/{moId}/VSANVcGetWitnessHosts
COPY
Path Parameters
string
moId
Required

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}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
VSANVcGetWitnessHostsRequestType of type(s) application/json
Required
"VSANVcGetWitnessHostsRequestType Object"
cluster
Required

The target cluster to query;

Required privileges: System.Read

Authentication
This operation uses the following authentication methods.
Responses
200

VSANWitnessHostInfo[] which contains witness host's UUID, ManagedEntity instance, preferred Fault Domain's user friendly name and UUID, IP address of unicast agent, and name of the Fault Domain that witness host resides in. If specified cluster in vSAN stretched cluster, all fields above will be set to actual setting, otherwise all fields will be unset.

[
    "VimClusterVSANWitnessHostInfo Object"
]

500

InvalidState: If any host in target cluster is not connected to vCenter server;

VsanFault: If any unexpected runtime fault is met.

Returns VimFault of type(s) application/json
This response body class contains all of the following: InlineVimFault0
"VimFault Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VimClusterVsanVcStretchedClusterSystem/{moId}/VSANVcGetWitnessHosts