Distributed Virtual Switch Merge Dvs Task

Distributed Virtual Switch Merge Dvs Task

Deprecated as of vSphere API 5.5.

Merge an existing DistributedVirtualSwitch (source) to this switch (destination).

The host members and the connected entity of the source switch will be transferred to the destination switch. This operation disconnects the entities from the source switch, tears down its host proxy switches, creates new proxies for the destination switch, and reconnects the entities to the destination switch.

In summary, this operation does the following:

  • Adds the config.maxPorts of the source switch to the maxPorts of the destination switch.
  • The host members of the source switch leave the source switch and join the destination switch with the same Physical NIC and VirtualSwitch (if applicable). A set of new uplink ports, compliant with the uplinkPortPolicy, is created as the hosts join the destination switch.
  • The portgroups on the source switch are copied over to destination switch, by calculating the effective default port config and creating a portgroup of the same name in the destination switch. If the name already exists, the copied portgroup uses names following a "Copy of switch-portgroup-name" scheme to avoid conflict. The same number of ports are created inside each copied portgroup.
  • The standalone distributed virtual ports are not copied, unless there is a virtual machine or host virtual NIC connecting to it. In that case, the operation calculates the effective port config and creates a port in the destination switch with the same name. Name conflict is resolved using numbers like "original-port-name(1)". The uplink ports are not copied over.
  • The virtual machine and host virtual NICs are disconnected from the source switch and reconnected with the destination switch, to the copied standalone port or portgroup.
  • If you are using a VmwareDistributedVirtualSwitch - Unless the PVLAN map contains exactly the same entries between the source and destination VMware distributed virtual switches, the method raises a fault if pvlanId is set in any port, portgroup, or switch that will be copied.

Required privileges: DVSwitch.Modify

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/DistributedVirtualSwitch/{moId}/MergeDvs_Task
COPY
Path Parameters
string
moId
Required

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}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.


Request Body
MergeDvsRequestType of type(s) application/json
Required
{
    "dvs": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    }
}
dvs
Required

Reference to an instance of the DistributedVirtualSwitch managed object.

Authentication
This operation uses the following authentication methods.
Responses
200

Returns a Task object with which to monitor the operation.

Returns MoRefTask of type(s) application/json
This response body class contains all of the following: MoRefExtensibleManagedObject
{
    "_typeName": "string",
    "type": "string",
    "value": "string"
}

500

NotSupported: If called directly on a host.

ResourceInUse: If failed to delete the source 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.

Returns VimFault of type(s) application/json
This response body class contains all of the following: MethodFault
{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

Distributed Virtual Switch Operations
POST
Distributed Virtual Switch Add DV Portgroup Task
POST
Distributed Virtual Switch Add Network Resource Pool
POST
Distributed Virtual Switch Create DV Portgroup Task
POST
Distributed Virtual Switch Destroy Task
POST
Distributed Virtual Switch Dvs Reconfigure Vm Vnic Network Resource Pool Task
POST
Distributed Virtual Switch DVS Rollback Task
POST
Distributed Virtual Switch Enable Network Resource Management
POST
Distributed Virtual Switch Fetch DV Port Keys
POST
Distributed Virtual Switch Fetch DV Ports
GET
Distributed Virtual Switch Get Alarm Actions Enabled
GET
Distributed Virtual Switch Get Available Field
GET
Distributed Virtual Switch Get Capability
GET
Distributed Virtual Switch Get Config
GET
Distributed Virtual Switch Get Config Issue
GET
Distributed Virtual Switch Get Config Status
GET
Distributed Virtual Switch Get Custom Value
GET
Distributed Virtual Switch Get Declared Alarm State
GET
Distributed Virtual Switch Get Disabled Method
GET
Distributed Virtual Switch Get Effective Role
GET
Distributed Virtual Switch Get Name
GET
Distributed Virtual Switch Get Network Resource Pool
GET
Distributed Virtual Switch Get Overall Status
GET
Distributed Virtual Switch Get Parent
GET
Distributed Virtual Switch Get Permission
GET
Distributed Virtual Switch Get Portgroup
GET
Distributed Virtual Switch Get Recent Task
GET
Distributed Virtual Switch Get Runtime
GET
Distributed Virtual Switch Get Summary
GET
Distributed Virtual Switch Get Tag
GET
Distributed Virtual Switch Get Triggered Alarm State
GET
Distributed Virtual Switch Get Uuid
GET
Distributed Virtual Switch Get Value
POST
Distributed Virtual Switch Lookup Dv Port Group
POST
Distributed Virtual Switch Merge Dvs Task
POST
Distributed Virtual Switch Move DV Port Task
POST
Distributed Virtual Switch Perform Dvs Product Spec Operation Task
POST
Distributed Virtual Switch Query Used Vlan Id In Dvs
POST
Distributed Virtual Switch Reconfigure DV Port Task
POST
Distributed Virtual Switch Reconfigure Dvs Task
POST
Distributed Virtual Switch Rectify Dvs Host Task
POST
Distributed Virtual Switch Refresh DV Port State
POST
Distributed Virtual Switch Reload
POST
Distributed Virtual Switch Remove Network Resource Pool
POST
Distributed Virtual Switch Rename Task
POST
Distributed Virtual Switch Set Custom Value
POST
Distributed Virtual Switch Update Dvs Capability
POST
Distributed Virtual Switch Update DVS Health Check Config Task
POST
Distributed Virtual Switch Update Network Resource Pool