Guest Process Manager Terminate Process In Guest
Terminates a process in the guest OS.
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 GuestProcessManager/{moId}
.
The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.
"TerminateProcessInGuestRequestType Object"
Virtual machine to perform the operation on.
Required privileges: VirtualMachine.GuestOperations.Execute
The guest authentication data. See GuestAuthentication.
Process ID of the process to be terminated
No Content
GuestOperationsFault: if there is an error processing a guest operation.
GuestOperationsUnavailable: if the VM agent for guest operations is not running.
InvalidPowerState: if the VM is not powered on.
InvalidState: if the operation cannot be performed because of the virtual machine's current state.
GuestProcessNotFound: if the pid does not refer to a valid process.
TaskInProgress: if the virtual machine is busy.
GuestPermissionDenied: if the process cannot be terminated because the guest authentication will not allow the operation.
InvalidGuestLogin: if the the guest authentication information was not accepted.
GuestComponentsOutOfDate: if the guest agent is too old to support the operation.
OperationNotSupportedByGuest: if the operation is not supported by the guest OS.
OperationDisabledByGuest: if the operation is not enabled due to guest agent configuration.
"VimFault Object"
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/GuestProcessManager/{moId}/TerminateProcessInGuest