Managed Object - DistributedVirtualSwitchManager

Property of: ServiceContent
See also: DistributedVirtualSwitch, DistributedVirtualSwitchHostProductSpec, DistributedVirtualSwitchProductSpec, DVSManagerDvsConfigTarget, HostSystem, ManagedEntity
Since: vSphere API 4.0

Managed Object Description

The interface to provide relevant information of DistributedVirtualSwitch.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
QueryAvailableDvsSpec, QueryCompatibleHostForExistingDvs, QueryCompatibleHostForNewDvs, QueryDvsByUuid, QueryDvsCompatibleHostSpec, QueryDvsConfigTarget

QueryAvailableDvsSpec

This operation returns a list of switch product specification that are supported by the Virtual Center Server.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.

Return Value

Type	Description
DistributedVirtualSwitchProductSpec[]

Faults

Type	Description
NotSupported	Thrown if called directly on a host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryAvailableDvsSpec" type="vim25:QueryAvailableDvsSpecRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryAvailableDvsSpecResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:DistributedVirtualSwitchProductSpec" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

QueryCompatibleHostForExistingDvs

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

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.
container	ManagedObjectReference to a ManagedEntity	Where to look for hosts. Supported types of object for this parameter are Datacenter, ComputeResource and Folder.
recursive	xsd:boolean	Whether to search for hosts in the subfolders, if applicable.
dvs	ManagedObjectReference to a DistributedVirtualSwitch	Search the host based on the specification published in the compatibleHostComponentProductInfo of a DistributedVirtualSwitch. If not set, it's assumed to be the specification that a DistributedVirtualSwitch would have if it is created with the default DistributedVirtualSwitchProductSpec.

Return Value

Type	Description
ManagedObjectReference[] to a HostSystem[]

Faults

Type	Description
InvalidArgument	Thrown if the switch value is not valid or recognized.
NotSupported	Thrown if called directly on a host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryCompatibleHostForExistingDvs" type="vim25:QueryCompatibleHostForExistingDvsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryCompatibleHostForExistingDvsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

QueryCompatibleHostForNewDvs

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

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.
container	ManagedObjectReference to a ManagedEntity	Where to look for hosts. Supported types of object for this parameter are Datacenter, ComputeResource and Folder.
recursive	xsd:boolean	Whether to search for hosts in the subfolders, if applicable.
switchProductSpec*	DistributedVirtualSwitchProductSpec	The productSpec of a DistributedVirtualSwitch. If not set, it's assumed to be the default one used for DistributedVirtualSwitch creation.

*Need not be set

Return Value

Type	Description
ManagedObjectReference[] to a HostSystem[]

Faults

Type	Description
InvalidArgument	Thrown if the productSpec value is not valid or recognized.
NotSupported	Thrown if called directly on a host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryCompatibleHostForNewDvs" type="vim25:QueryCompatibleHostForNewDvsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryCompatibleHostForNewDvsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

QueryDvsByUuid

This operation returns a DistributedVirtualSwitch given a uuid.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.
uuid	xsd:string

Return Value

Type	Description
ManagedObjectReference to a DistributedVirtualSwitch

Faults

Type	Description
NotFound	Thrown if a switch with the UUID doesn't exist.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsByUuid" type="vim25:QueryDvsByUuidRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsByUuidResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0"/>
               </sequence>
            </complexType>
         </element>

QueryDvsCompatibleHostSpec

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

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.
switchProductSpec*	DistributedVirtualSwitchProductSpec	The productSpec of a DistributedVirtualSwitch. If not set, it's assumed to be the default one used for DistributedVirtualSwitch creation.

*Need not be set

Return Value

Type	Description
DistributedVirtualSwitchHostProductSpec[]

Faults

Type	Description
InvalidArgument	Thrown if the switchProductSpec value is not valid or recognized.
NotSupported	Thrown if called directly on a host.
NotSupported	Thrown if called directly on a host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsCompatibleHostSpec" type="vim25:QueryDvsCompatibleHostSpecRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsCompatibleHostSpecResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:DistributedVirtualSwitchHostProductSpec" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

QueryDvsConfigTarget

This operation returns the DistributedVirtualSwitch or DistributedVirtualPortgroup config target on a host.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualSwitchManager used to make the method call.
host*	ManagedObjectReference to a HostSystem	The host on which the query is to be made. If called directly on the host this parameter need not be specified.
dvs*	ManagedObjectReference to a DistributedVirtualSwitch	The distributed virtual switch on which the query is to be made. If unspecified the config target will encompass all the distributed virtual switches available on the host.

*Need not be set

Return Value

Type	Description
DVSManagerDvsConfigTarget

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsConfigTarget" type="vim25:QueryDvsConfigTargetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryDvsConfigTargetResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:DVSManagerDvsConfigTarget"/>
               </sequence>
            </complexType>
         </element>