Distributed Virtual Switch Reconfigure Dvs Task
Reconfigures a distributed virtual switch.
You can use this method to set switch properties or to reset the switch to a previous state.
Reconfiguring a Standard Distributed Virtual Switch
To reconfigure a DistributedVirtualSwitch, use a DVSConfigSpec to set the switch properties.
Reconfiguring a VMware Distributed Virtual Switch
If you use a VmwareDistributedVirtualSwitch, you can perform the following switch reconfiguration:
- Use a VMwareDVSConfigSpec to set the switch properties.
- Use the VMwareDVSConfigSpec returned by DVSRollback_Task to reset the switch to a previous state.
Reconfiguring the switch may require any of the following privileges, depending on what is being changed:
- DVSwitch.PolicyOp if policy is set.
- DVSwitch.PortSetting if defaultPortConfig is set.
- DVSwitch.HostOp if policy is set. The user will also need the Host.Config.Network privilege on the host.
- DVSwitch.Vspan if vspanConfigSpec is set.
- DVSwitch.Modify for anything else.
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 DistributedVirtualSwitch/{moId}.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
"ReconfigureDvsRequestType Object"The DVSConfigSpec data object contains configuration data for a DistributedVirtualSwitch.
Use the ReconfigureDvs_Task method to apply the configuration to the switch.
Returns a Task object with which to monitor the operation.
"MoRefTask Object"NotSupported: if called directly on a host or if the spec includes settings for any vNetwork Distributed Switch feature that is not supported on this switch.
DvsFault: if operation fails on any host or if there are other update failures.
DvsNotAuthorized: if login-session's extension key does not match the switch's configured extensionKey.
ResourceNotAvailable: If there is no port available in the portgroup
VspanPortConflict: if dvPort is used as both the transmitted source and destination ports in Distributed Port Mirroring sessions.
VspanPromiscuousPortNotSupported: if a promiscuous port is used as transmitted source or destination in the Distributed Port Mirroring sessions.
VspanSameSessionPortConflict: if a dvPort is used as both the source and destination in the same Distributed Port Mirroring session.
VspanDestPortConflict: if a dvPort is used as desination ports in multiple Distributed Port Mirroring sessions.
"VimFault Object" curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/DistributedVirtualSwitch/{moId}/ReconfigureDvs_Task