Distributed Virtual Switch Manager Query Compatible Host For New 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}/QueryCompatibleHostForNewDvs

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

QueryCompatibleHostForNewDvsRequestType of type(s) application/json

Required

"QueryCompatibleHostForNewDvsRequestType 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.

switchProductSpec

Optional

The productSpec of a DistributedVirtualSwitch. If not set, it is assumed to be the default one used for DistributedVirtualSwitch creation.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

[
    "MoRefHostSystem Object"
]

array of MoRefHostSystem

Optional

Code Samples

COPY

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

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

200 Response Body

Virtual Infrastructure Operations

POST

Distributed Virtual Switch Manager Query Dvs Check Compatibility

POST