ANSIBLE.VIRT(3)

NAME
virt - Manages virtual machines supported by libvirt

DESCRIPTION

Manages virtual machines supported by libvirt.

OPTIONS

command
    in addition to state management, various non-idempotent commands are available. See examples Choices: create,status,start,stop,pause,unpause,shutdown,undefine,destroy,get_xml,autostart,freemem,list_vms,info,nodeinfo,virttype.

name
    name of the guest VM being managed(required)

state
    Note that there may be some lag for state requests like shutdown since these refer only to VM states. After starting a guest, it may not be immediately accessible. Choices: running,shutdown. (default: no)."

EXAMPLES

Example from Ansible Playbooks
virt: name=alpha state=running

Example guest management with /usr/bin/ansible
ansible host -m virt -a "name=alpha command=status"

Use /usr/bin/ansible to get the xml of the guest machine alpha
ansible host -m virt -a "name=alpha command=get_xml"
None

AUTHOR
Michael DeHaan, Seth Vidal

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#virt