Distributed Virtual Switch Manager Query Compatible Host For Existing Dvs

Distributed Virtual Switch Manager Query Compatible Host For Existing Dvs

This operation returns a list of hosts that are compatible with the given DistributedVirtualSwitch product specification.

Required privileges: System.View

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/DistributedVirtualSwitchManager/{moId}/QueryCompatibleHostForExistingDvs
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 DistributedVirtualSwitchManager/{moId}.

string
release
Required

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


Request Body
Required
"QueryCompatibleHostForExistingDvsRequestType Object"
container
Required

Where to look for hosts. Supported types of objects for this parameter are Datacenter, ComputeResource and Folder.

boolean
recursive
Required

Whether to search for hosts in the subfolders, if applicable. In the case when container is a Datacenter, the recursive flag is applied to its HostFolder.

dvs
Required

Search the host based on the specification published in the DVSCapability.compatibleHostComponentProductInfo of a DistributedVirtualSwitch. If not set, it is assumed to be the specification that a DistributedVirtualSwitch would have if it is created with the default DistributedVirtualSwitchProductSpec.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

[
    "MoRefHostSystem Object"
]
Optional

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