Adding upstream version 2.14.3.upstream/2.14.3upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 52 insertions, 0 deletions

diff --git a/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/run_a_vm.rst b/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/run_a_vm.rst
new file mode 100644
index 0000000..be72386
--- /dev/null
+++ b/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/run_a_vm.rst
@@ -0,0 +1,52 @@
+.. _vmware_rest_run_a_vm:
+
+****************************
+How to run a virtual machine
+****************************
+
+.. contents::
+  :local:
+
+
+Introduction
+============
+
+This section covers the power management of your virtual machine.
+
+Power information
+=================
+
+Use ``vcenter_vm_power_info`` to know the power state of the VM.
+
+.. literalinclude:: task_outputs/Get_guest_power_information.task.yaml
+
+Result
+______
+
+.. literalinclude:: task_outputs/Get_guest_power_information.result.json
+
+
+How to start a virtual machine
+==============================
+
+Use the ``vcenter_vm_power`` module to start your VM:
+
+.. literalinclude:: task_outputs/Turn_the_power_of_the_VM_on.task.yaml
+
+Result
+______
+
+.. literalinclude:: task_outputs/Turn_the_power_of_the_VM_on.result.json
+
+How to wait until my virtual machine is ready
+=============================================
+
+If your virtual machine runs VMware Tools, you can build a loop
+around the ``center_vm_tools_info`` module:
+
+.. literalinclude:: task_outputs/Wait_until_my_VM_is_ready.task.yaml
+
+Result
+______
+
+.. literalinclude:: task_outputs/Wait_until_my_VM_is_ready.result.json