57 lines
No EOL
1.6 KiB
ReStructuredText
57 lines
No EOL
1.6 KiB
ReStructuredText
.. _virt:
|
|
|
|
virt
|
|
``````````````````````````````
|
|
|
|
.. versionadded:: 0.2
|
|
|
|
Manages virtual machines supported by *libvirt*.
|
|
|
|
.. raw:: html
|
|
|
|
<table>
|
|
<tr>
|
|
<th class="head">parameter</th>
|
|
<th class="head">required</th>
|
|
<th class="head">default</th>
|
|
<th class="head">choices</th>
|
|
<th class="head">comments</th>
|
|
</tr>
|
|
<tr>
|
|
<td>state</td>
|
|
<td>no</td>
|
|
<td>no</td>
|
|
<td><ul><li>running</li><li>shutdown</li><li>destroyed</li><li>undefined</li></ul></td>
|
|
<td>Note that there may be some lag for state requests like <code>shutdown</code> since these refer only to VM states. After starting a guest, it may not be immediately accessible.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>command</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>in addition to state management, various non-idempotent commands are available. See examples</td>
|
|
</tr>
|
|
<tr>
|
|
<td>name</td>
|
|
<td>yes</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>name of the guest VM being managed</td>
|
|
</tr>
|
|
</table>
|
|
|
|
.. raw:: html
|
|
|
|
<p>Example from Ansible Playbooks</p> <p><pre>
|
|
virt guest=alpha state=running
|
|
</pre></p>
|
|
<p>Example guest management with <code>/usr/bin/ansible</code></p> <p><pre>
|
|
ansible host -m virt -a "guest=alpha command=status"
|
|
</pre></p>
|
|
<br/>
|
|
|
|
.. raw:: html
|
|
|
|
<h4>Notes</h4>
|
|
<p>Other non-idempotent commands are: <code>status</code>, <code>pause</code>, <code>unpause</code>, <code>get_xml</code>, <code>autostart</code>, <code>freemem</code>, <code>list_vms</code>, <code>info</code>, <code>nodeinfo</code>, <code>virttype</code></p>
|
|
|