Distributed Virtual Switch Manager Query Dvs Feature Capability

This operation indicates which version-specific DVS features are available for the given DistributedVirtualSwitch product specification.

Required privileges: System.View

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/DistributedVirtualSwitchManager/{moId}/QueryDvsFeatureCapability

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 8.0.2.0 APIs.

Request Body

QueryDvsFeatureCapabilityRequestType of type(s) application/json

Required

{
    "switchProductSpec": {
        "name": "string",
        "vendor": "string",
        "version": "string",
        "build": "string",
        "forwardingClass": "string",
        "bundleId": "string",
        "bundleUrl": "string"
    }
}

DistributedVirtualSwitchProductSpec

switchProductSpec

Optional

This data object type is a subset of AboutInfo.

An object of this type can be used to describe the specification for a proxy switch module of a DistributedVirtualSwitch.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

Returns DVSFeatureCapability of type(s) application/json

This response body class contains all of the following: DataObject

{
    "_typeName": "string",
    "networkResourceManagementSupported": false,
    "vmDirectPathGen2Supported": false,
    "nicTeamingPolicy": [
        "string"
    ],
    "networkResourcePoolHighShareValue": 0,
    "networkResourceManagementCapability": {
        "networkResourceManagementSupported": false,
        "networkResourcePoolHighShareValue": 0,
        "qosSupported": false,
        "userDefinedNetworkResourcePoolsSupported": false,
        "networkResourceControlVersion3Supported": false,
        "userDefinedInfraTrafficPoolSupported": false
    },
    "healthCheckCapability": {
        "_typeName": "string"
    },
    "rollbackCapability": {
        "rollbackSupported": false
    },
    "backupRestoreCapability": {
        "backupRestoreSupported": false
    },
    "networkFilterSupported": false,
    "macLearningSupported": false
}

boolean

networkResourceManagementSupported

Required

Deprecated as of vSphere API 5.0, use networkResourceManagementCapability.DVSNetworkResourceManagementCapability.networkResourceManagementSupported.

Indicates whether network I/O control is supported on the vSphere Distributed Switch.

boolean

vmDirectPathGen2Supported

Optional

Deprecated as of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

Indicates whether VMDirectPath Gen 2 is supported on the distributed virtual switch.

See HostCapability.HostCapability.vmDirectPathGen2Supported and PhysicalNic.PhysicalNic.vmDirectPathGen2Supported.

For a third-party distributed switch implementation, you can specify this property during switch creation or when you call the DistributedVirtualSwitch.UpdateDvsCapability method.

VMDirectPath Gen 2 is supported in vSphere Distributed Switch Version 4.1 or later.

array of string

nicTeamingPolicy

Optional

The available teaming modes for the vSphere Distributed Switch.

The value can be one or more of DistributedVirtualSwitchNicTeamingPolicyModeEnum.

integer As int32 As int32

networkResourcePoolHighShareValue

Optional

Deprecated as of vSphere API 5.0, use networkResourceManagementCapability.DVSNetworkResourceManagementCapability.networkResourcePoolHighShareValue.

This is the value for high in DVSNetworkResourcePoolAllocationInfo.shares.

This implicitly defines the legal range of share values to be between 1 and this. This also defines values for other level types, such as normal being one half of this value and low being one fourth of this value.

DVSNetworkResourceManagementCapability

networkResourceManagementCapability

Optional

Dataobject representing the feature capabilities of network resource management supported by the vSphere Distributed Switch.

DVSHealthCheckCapability

healthCheckCapability

Optional

Health check capabilities of health check supported by the vSphere Distributed Switch

DVSRollbackCapability

rollbackCapability

Optional

The DVSRollbackCapability data object describes the rollback capabilities for a DistributedVirtualSwitch.

DVSBackupRestoreCapability

backupRestoreCapability

Optional

The DVSBackupRestoreCapability data object describes backup, restore, and rollback capabilities for distributed virtual switches and distributed virtual portgroups.

Backup and restore capabilities are indicated for DistributedVirtualSwitch. Rollback capability is indicated for DistributedVirtualSwitch and DistributedVirtualPortgroup.

boolean

networkFilterSupported

Optional

Indicates whether Network Filter feature is supported in vSphere Distributed Switch.

boolean

macLearningSupported

Optional

Indicates whether MAC learning feature is supported in vSphere Distributed Switch.

On This Page

Description

Request