Managed Object - DistributedVirtualPortgroup

Property of: DistributedVirtualPortgroupInfo, DistributedVirtualSwitch, DVSConfigInfo, DVSConfigSpec
Extends: Network
See also: DVPortgroupConfigInfo, DVPortgroupConfigSpec
Since: vSphere API 4.0

Managed Object Description

The DistributedVirtualPortgroup managed object defines how hosts and virtual machines connect to a network. A distributed virtual portgroup specifies DistributedVirtualPort configuration options for the ports on a DistributedVirtualSwitch. A portgroup also represents a Network entity in the datacenter.

To configure host access by portgroup, set the portgroup in the host virtual NIC specification (HostVirtualNicSpec.portgroup).

To configure virtual machine access by portgroup, set the portgroup in the virtual Ethernet card backing (VirtualEthernetCard.backing.port.portgroupKey).

When you use a portgroup for network access, the Server will create a port according to config.type.

Properties

Name	Type	Description
config	DVPortgroupConfigInfo	Configuration of the portgroup.
key	xsd:string	Generated UUID of the portgroup.
portKeys*	xsd:string[]	Port keys for the set of ports in the portgroup.
Properties inherited from Network
host, name, summary, vm
Properties inherited from ManagedEntity
alarmActionsEnabled, configIssue, configStatus, customValue, declaredAlarmState, disabledMethod, effectiveRole, name, overallStatus, parent, permission, recentTask, tag, triggeredAlarmState
Properties inherited from ExtensibleManagedObject
availableField, value

*May not be present

Methods

Methods defined in this Managed Object
ReconfigureDVPortgroup_Task
Methods inherited from Network
DestroyNetwork
Methods inherited from ManagedEntity
Destroy_Task, Reload, Rename_Task
Methods inherited from ExtensibleManagedObject
setCustomValue

ReconfigureDVPortgroup_Task

Reconfigures one or more distributed virtual portgroups. You can use this method to set portgroup properties or to reset the portgroup to a previous state.

Reconfiguring a Standard Distributed Virtual Portgroup

To reconfigure a DistributedVirtualPortgroup, use a DVPortgroupConfigSpec to set the portgroup properties.

Reconfiguring a Portgroup Associated With a VMware Distributed Virtual Switch

If you use a VmwareDistributedVirtualSwitch, you can perform the following portgroup reconfiguration:

Use a DVPortgroupConfigSpec to set the portgroup properties.

Use the DVPortgroupConfigSpec returned by DVPortgroupRollback_Task to reset the portgroup to a previous state.

The following privileges are required to reconfigure a portgroup.

DVPortgroup.PolicyOp if you are changing the policy of the portgroup.
DVPortgroup.ScopeOp if you are changing the scope of the portgroup.
DVPortgroup.Modify for anything else.

Required Privileges: Dynamic - See discussion above

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DistributedVirtualPortgroup used to make the method call.
spec	DVPortgroupConfigSpec	Configuration data for the portgroup.

Return Value

Type	Description
ManagedObjectReference to a SmsTask

Faults

Type	Description
ConcurrentAccess
DuplicateName
DvsFault	Thrown if spec is not valid.
DvsNotAuthorized	Thrown if login-session's extension key does not match the switch's configured extensionKey.
InvalidName
NotSupported	Thrown if the spec includes settings for any VDS feature that is not supported on this switch.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None