Virtual Machine Drop Connections

Virtual Machine Drop Connections

Force the virtual machine to drop the specified connections.

Attempt to drop the specified virtual machine connections. An attempt will be made to drop all of the specified connections before returning.

Since: vSphere API Release 7.0.1.0

Required privileges: VirtualMachine.Interact.ConsoleInteract

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/VirtualMachine/{moId}/DropConnections

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 VirtualMachine/{moId}.

string

release

Required

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

Request Body

DropConnectionsRequestType of type(s) application/json

Required

{
    "listOfConnections": [
        {
            "_typeName": "string",
            "label": "string",
            "client": "string",
            "userName": "string"
        }
    ]
}

array of VirtualMachineConnection

listOfConnections

Optional

listOfConnections

Authentication

This operation uses the following authentication methods.

Session

Responses

200

true All of the specified connections have been dropped.

Returns integer of type(s) application/json

Operation doesn't return any data structure

500

InvalidPowerState: If the virtual machine is not powered on. No connection drop actions will have been attempted if this is thrown.

Returns InvalidState of type(s) application/json

This response body class contains all of the following: VimFault

{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

Availability

Added in vSphere API Release 7.0.1.0

On This Page

Request

Path Parameters

200 Response Body

Errors

Virtual Infrastructure Operations

Virtual Machine Acquire Mks Ticket

Virtual Machine Acquire Ticket

Virtual Machine Answer VM

Virtual Machine Apply Evc Mode VM Task

Virtual Machine Attach Disk Task

Virtual Machine Check Customization Spec

Virtual Machine Clone VM Task

Virtual Machine Consolidate VM Disks Task

Virtual Machine Create Screenshot Task

Virtual Machine Create Secondary VM Task

Virtual Machine Create Secondary VM Ex Task

Virtual Machine Create Snapshot Task

Virtual Machine Create Snapshot Ex Task

Virtual Machine Crypto Unlock Task

Virtual Machine Customize VM Task

Virtual Machine Defragment All Disks

Virtual Machine Destroy Task

Virtual Machine Detach Disk Task

Virtual Machine Disable Secondary VM Task

Virtual Machine Drop Connections

Virtual Machine Enable Secondary VM Task

Virtual Machine Estimate Storage For Consolidate Snapshots Task

Virtual Machine Export Vm

Virtual Machine Extract Ovf Environment

Virtual Machine Get Alarm Actions Enabled

Virtual Machine Get Available Field

Virtual Machine Get Capability

Virtual Machine Get Config

Virtual Machine Get Config Issue

Virtual Machine Get Config Status

Virtual Machine Get Custom Value

Virtual Machine Get Datastore

Virtual Machine Get Declared Alarm State

Virtual Machine Get Disabled Method

Virtual Machine Get Effective Role

Virtual Machine Get Environment Browser

Virtual Machine Get Guest

Virtual Machine Get Guest Heartbeat Status

Virtual Machine Get Layout

Virtual Machine Get Layout Ex

Virtual Machine Get Name

Virtual Machine Get Network

Virtual Machine Get Overall Status

Virtual Machine Get Parent

Virtual Machine Get Parent V App

Virtual Machine Get Permission

Virtual Machine Get Recent Task

Virtual Machine Get Resource Config

Virtual Machine Get Resource Pool

Virtual Machine Get Root Snapshot

Virtual Machine Get Runtime

Virtual Machine Get Snapshot

Virtual Machine Get Storage

Virtual Machine Get Summary

Virtual Machine Get Tag

Virtual Machine Get Triggered Alarm State

Virtual Machine Get Value

Virtual Machine Instant Clone Task

Virtual Machine Make Primary VM Task

Virtual Machine Mark As Template

Virtual Machine Mark As Virtual Machine

Virtual Machine Migrate VM Task

Virtual Machine Mount Tools Installer

Virtual Machine Power Off VM Task

Virtual Machine Power On VM Task

Virtual Machine Promote Disks Task

Virtual Machine Put Usb Scan Codes

Virtual Machine Query Changed Disk Areas

Virtual Machine Query Connections

Virtual Machine Query Fault Tolerance Compatibility

Virtual Machine Query Fault Tolerance Compatibility Ex

Virtual Machine Query Unowned Files

Virtual Machine Reboot Guest

Virtual Machine Reconfig VM Task

Virtual Machine Refresh Storage Info

Virtual Machine Reload

Virtual Machine Reload Virtual Machine From Path Task

Virtual Machine Relocate VM Task

Virtual Machine Remove All Snapshots Task

Virtual Machine Rename Task

Virtual Machine Reset Guest Information

Virtual Machine Reset VM Task

Virtual Machine Revert To Current Snapshot Task

Virtual Machine Send NMI

Virtual Machine Set Custom Value

Virtual Machine Set Display Topology

Virtual Machine Set Screen Resolution

Virtual Machine Shutdown Guest

Virtual Machine Standby Guest

Virtual Machine Start Recording Task

Virtual Machine Start Replaying Task

Virtual Machine Stop Recording Task

Virtual Machine Stop Replaying Task

Virtual Machine Suspend VM Task

Virtual Machine Terminate Fault Tolerant VM Task

Virtual Machine Terminate VM

Virtual Machine Turn Off Fault Tolerance For VM Task

Virtual Machine Unmount Tools Installer

Virtual Machine Unregister VM

Virtual Machine Upgrade Tools Task

Virtual Machine Upgrade VM Task