mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
91 lines
2.3 KiB
ReStructuredText
91 lines
2.3 KiB
ReStructuredText
.. _vmware_rest_vm_tool_information:
|
|
|
|
*****************************************************
|
|
How to get information from a running virtual machine
|
|
*****************************************************
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
|
|
Introduction
|
|
============
|
|
|
|
This section shows you how to collection information from a running virtual machine.
|
|
|
|
Scenario requirements
|
|
=====================
|
|
|
|
You've already followed :ref:`vmware_rest_run_a_vm` and your virtual machine runs VMware Tools.
|
|
|
|
How to collect information
|
|
==========================
|
|
|
|
In this example, we use the ``vcenter_vm_guest_*`` module to collect information about the associated resources.
|
|
|
|
Filesystem
|
|
----------
|
|
|
|
Here we use ``vcenter_vm_guest_localfilesystem_info`` to retrieve the details
|
|
about the filesystem of the guest. In this example we also use a ``retries``
|
|
loop. The VMware Tools may take a bit of time to start and by doing so, we give
|
|
the VM a bit more time.
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_filesystem_information.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_filesystem_information.result.json
|
|
|
|
Guest identity
|
|
--------------
|
|
|
|
You can use ``vcenter_vm_guest_identity_info`` to get details like the OS family or the hostname of the running VM.
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_identity_information.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_identity_information.result.json
|
|
|
|
Network
|
|
-------
|
|
|
|
``vcenter_vm_guest_networking_info`` will return the OS network configuration.
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_networking_information.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_networking_information.result.json
|
|
|
|
Network interfaces
|
|
------------------
|
|
|
|
``vcenter_vm_guest_networking_interfaces_info`` will return a list of NIC configurations.
|
|
|
|
See also :ref:`vmware_rest_attach_a_network`.
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_network_interfaces_information.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_network_interfaces_information.result.json
|
|
|
|
Network routes
|
|
--------------
|
|
|
|
Use ``vcenter_vm_guest_networking_routes_info`` to explore the route table of your virtual machine.
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_network_routes_information.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Get_guest_network_routes_information.result.json
|
|
|