Managed Object - DistributedVirtualPortgroup(vim.dvs.DistributedVirtualPortgroup)

Property of
DistributedVirtualPortgroupInfo, DistributedVirtualSwitch, DistributedVirtualSwitchManagerImportResult, DVSConfigInfo, DVSConfigSpec
Returned by
CreateDVPortgroup_Task, DVSManagerLookupDvPortGroup, LookupDvPortGroup
Extends
Network
See also
DVPortgroupConfigInfo, DVPortgroupConfigSpec, EntityBackupConfig
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.

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

Properties

Name Type Description
configDVPortgroupConfigInfo

Configuration of the portgroup.
keyxsd: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
DVPortgroupRollback_Task, ReconfigureDVPortgroup_Task
Methods inherited from Network
DestroyNetwork
Methods inherited from ManagedEntity
Destroy_Task, Reload, Rename_Task
Methods inherited from ExtensibleManagedObject
setCustomValue

DVPortgroupRollback_Task(rollback)

This method determines if the portgroup configuration has changed. If it has changed, the method returns a DVPortgroupConfigSpec. Use the ReconfigureDVPortgroup_Task method to apply the rollback configuration to the portgroup. You can use the rollback method only on a portgroup that is associated with a VmwareDistributedVirtualSwitch.

To use the rollback method, you must have the DVPortgroup.Read privilege.

Required Privileges
Dynamic - See discussion above
Since
vSphere API 5.1

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the DistributedVirtualPortgroup used to make the method call.
entityBackup*EntityBackupConfig

The backup of Distributed Virtual PortGroup entity.
*Need not be set

Return Value

Type Description
ManagedObjectReference
to a Task
Returns a Task object with which to monitor the operation. If the distributed virtual portgroup configuration has changed, the Task.info.result property contains the DVPortgroupConfigSpec object.

Faults

Type Description
DvsFaultThrown if operation fails.
RollbackFailureThrown if there is no configuration specified in entityBackup and the previous configuration does not exist either
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None



ReconfigureDVPortgroup_Task(reconfigure)

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:

The following privileges are required to reconfigure a portgroup.

Required Privileges
Dynamic - See discussion above

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the DistributedVirtualPortgroup used to make the method call.
specDVPortgroupConfigSpec

Configuration data for the portgroup.

Return Value

Type Description
ManagedObjectReference
to a Task

Faults

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

Events

Type
None