kvm.shutdown

Shut down a KVM virtual machine.

JSON-RPC Request

{"jsonrpc":"2.0","id":1,"method":"kvm.shutdown","params":{"hostname":"kvm1"}}

Request Parameters

Argument	Type	Description	Required
`hostname`	String	The name of the virtual machine.	Yes
`force`	Boolean	Whether or not to force the virtual machine to shut down.	No

JSON-RPC Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "Shutting down kvm1..."
}

RVC CLI Example

rvc kvm shutdown --hostname kvm1

Response

Shutting down kvm1... 
checking status 30... 
checking status 29... 
kvm1 successfully shut off.

Output for a cluster managed virtual machine:

Shutting down kvm1...
Maintenance mode set to enabled.
checking status 30...
checking status 29...
checking status 28...
checking status 27...
checking status 26...
kvm1 successfully shut off.