Skip to content

Commit 03efeac

Browse files
committed
add hostid param for unmanageVirtualMachine API
1 parent 1a5fb2c commit 03efeac

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

source/adminguide/virtual_machines/importing_unmanaging_vms.rst

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -339,7 +339,19 @@ Unmanaging Instances
339339

340340
Administrators can unmanage guest Instances from CloudStack. Once unmanaged, CloudStack can no longer monitor, control or administer the provisioning and orchestration-related operations on an Instance.
341341

342-
To unmanage a guest Instance, an administrator must either use the UI or invoke the unmanageVirtualMachine API passing the ID of the Instance to unmanage. The API has the following preconditions:
342+
To unmanage a guest Instance, an administrator must either use the UI or invoke the unmanageVirtualMachine API passing the ID of the Instance to unmanage.
343+
344+
.. code:: bash
345+
346+
cmk unmanage virtualmachine id=<instance-id>
347+
348+
The API supports the `hostid` parameter for stopped instances on the KVM hypervisor, allowing the domain XML to be persisted on the specified host.
349+
350+
.. code:: bash
351+
352+
cmk unmanage virtualmachine id=<instance-id> hostid=<host-id>
353+
354+
The API has the following preconditions:
343355

344356
- The Instance must not be destroyed
345357
- The Instance state must be 'Running’ or ‘Stopped’

0 commit comments

Comments
 (0)