Flags

Domains

Power management flags

Action	Flags
destroy	graceful
reboot	see shutdown flags
reset	N/A
resume	N/A
shutdown	acpi_power_btn, guest_agent, initctl, signal, paravirt
start	paused, autodestroy, bypass_cache, force_boot, validate
suspend	N/A

These flags can be a string, or an array of strings to combine flags.

N.B. : If wrong flag specified, API will return an "Invalid flag" error.

Status flags

Flag	Desctription	Selector string
No State	no state	N/A
Running	the domain is running	running
Blocked	the domain is blocked on resource	N/A
Paused	the domain is paused by user	paused
Shutting down	the domain is being shut down	N/A
Shutoff	the domain is shut off	shutoff
Crashed	the domain is crashed	N/A
Power Management Suspended	the domain is suspended by guest power management	N/A

N.B. : Libvirt does not provide a selector flag for each possible status, but does provide a catch-all other for the selector flags not provided. HE wraps this directly and so will only accept the same selectors as libvirt, being running, shutoff, paused, and other.

Delete flags

Flag	Desctription
managed_save	Also remove any managed save
snapshots_metadata	If last use of domain, then also remove any snapshot metadata
nvram	Also remove any NVRAM file
keep_nvram	Keep NVRAM file