Vmware 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 VmwareDistributedVirtualSwitch/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"spec": {
"_typeName": "string",
"dynamicProperty": [
{
"_typeName": "string",
"name": "string",
"val": {
"_typeName": "string"
}
}
],
"configVersion": "string",
"name": "string",
"numStandalonePorts": 0,
"maxPorts": 0,
"uplinkPortPolicy": {
"_typeName": "string"
},
"uplinkPortgroup": [
{
"_typeName": "string",
"type": "string",
"value": "string"
}
],
"defaultPortConfig": {
"_typeName": "string",
"blocked": {
"_typeName": "string",
"inherited": false,
"value": false
},
"vmDirectPathGen2Allowed": {
"_typeName": "string",
"inherited": false,
"value": false
},
"inShapingPolicy": {
"_typeName": "string",
"inherited": false,
"enabled": {
"_typeName": "string",
"inherited": false,
"value": false
},
"averageBandwidth": {
"_typeName": "string",
"inherited": false,
"value": 0
},
"peakBandwidth": {
"_typeName": "string",
"inherited": false,
"value": 0
},
"burstSize": {
"_typeName": "string",
"inherited": false,
"value": 0
}
},
"outShapingPolicy": {
"_typeName": "string",
"inherited": false,
"enabled": {
"_typeName": "string",
"inherited": false,
"value": false
},
"averageBandwidth": {
"_typeName": "string",
"inherited": false,
"value": 0
},
"peakBandwidth": {
"_typeName": "string",
"inherited": false,
"value": 0
},
"burstSize": {
"_typeName": "string",
"inherited": false,
"value": 0
}
},
"vendorSpecificConfig": {
"_typeName": "string",
"inherited": false,
"keyValue": [
{
"_typeName": "string",
"key": "string",
"opaqueData": "string"
}
]
},
"networkResourcePoolKey": {
"_typeName": "string",
"inherited": false,
"value": "string"
},
"filterPolicy": {
"_typeName": "string",
"inherited": false,
"filterConfig": [
{
"_typeName": "string",
"inherited": false,
"key": "string",
"agentName": "string",
"slotNumber": "string",
"parameters": {
"_typeName": "string",
"parameters": [
"string"
]
},
"onFailure": "string"
}
]
}
},
"host": [
{
"_typeName": "string",
"dynamicProperty": [
{
"_typeName": "string",
"name": "string",
"val": {
"_typeName": "string"
}
}
],
"operation": "string",
"host": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"backing": {
"_typeName": "string"
},
"maxProxySwitchPorts": 0,
"vendorSpecificConfig": [
{
"_typeName": "string",
"key": "string",
"opaqueData": "string"
}
]
}
],
"extensionKey": "string",
"description": "string",
"policy": {
"_typeName": "string",
"autoPreInstallAllowed": false,
"autoUpgradeAllowed": false,
"partialUpgradeAllowed": false
},
"vendorSpecificConfig": [
{
"_typeName": "string",
"key": "string",
"opaqueData": "string"
}
],
"contact": {
"_typeName": "string",
"name": "string",
"contact": "string"
},
"switchIpAddress": "string",
"defaultProxySwitchMaxNumPorts": 0,
"infrastructureTrafficResourceConfig": [
{
"_typeName": "string",
"key": "string",
"description": "string",
"allocationInfo": {
"_typeName": "string",
"limit": 0,
"shares": {
"_typeName": "string",
"shares": 0,
"level": "string"
},
"reservation": 0
}
}
],
"netResourcePoolTrafficResourceConfig": [
{
"_typeName": "string",
"key": "string",
"description": "string",
"allocationInfo": {
"_typeName": "string",
"limit": 0,
"shares": {
"_typeName": "string",
"shares": 0,
"level": "string"
},
"reservation": 0
}
}
],
"networkResourceControlVersion": "string"
}
}
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.
{
"_typeName": "string",
"type": "string",
"value": "string"
}
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.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}