Module Expr Str ImportFrom alias Import alias Import alias Import alias Import alias ImportFrom alias ImportFrom alias Assign NameStore Call AttributeLoad NameLoad attr NameLoad Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad Str attr Str Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad Str attr Str FunctionDef arguments args defaults body Expr Str If Call NameLoad body If CompareIs Call AttributeLoad NameLoad attr Str NameLoad NameLoad body If UnaryOpNot Call SubscriptLoad NameLoad Index Str Str body Expr Call SubscriptLoad NameLoad Index Str Str Return NameLoad Return TupleLoad NameLoad Str decorator_list FunctionDef arguments args defaults body Expr Str Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list FunctionDef arguments args defaults body Expr Str Return Call NameLoad Str NameLoad Str decorator_list FunctionDef arguments args defaults body Expr Str Assign NameStore Dict Assign NameStore Call AttributeLoad Str attr Call NameLoad For NameStore Call AttributeLoad Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad attr body If UnaryOpNot Call AttributeLoad NameLoad attr body Continue Assign NameStore Call AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad SubscriptLoad NameLoad Index Num attr Str Str Assign SubscriptStore NameLoad Index NameLoad NameLoad Return NameLoad decorator_list FunctionDef arguments args defaults body Expr Str Return Call NameLoad Str NameLoad Str decorator_list FunctionDef arguments args defaults body Expr Str Assign NameStore Dict Assign NameStore Call NameLoad For NameStore NameLoad body Assign SubscriptStore NameLoad Index NameLoad Dict Str Str Str Str Str Str SubscriptLoad SubscriptLoad NameLoad Index NameLoad Index Str SubscriptLoad SubscriptLoad NameLoad Index NameLoad Index Str SubscriptLoad SubscriptLoad NameLoad Index NameLoad Index Str NameLoad ListLoad ListLoad Assign SubscriptStore SubscriptLoad NameLoad Index NameLoad Index Str Call AttributeLoad Str attr SubscriptLoad SubscriptLoad NameLoad Index NameLoad Index Str SubscriptLoad SubscriptLoad NameLoad Index NameLoad Index Str Return NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Dict Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad attr Return NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad attr Return NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str If UnaryOpNot Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad If CompareEq SubscriptLoad NameLoad Index Str Num body Return NameLoad Return SubscriptLoad NameLoad Index Str decorator_list FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call NameLoad If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad If CompareIs NameLoad NameLoad body AugAssignAdd NameStore Str Assign NameStore Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad If CompareEq SubscriptLoad NameLoad Index Str Num body Return NameLoad Return SubscriptLoad NameLoad Index Str decorator_list FunctionDef arguments args NameParam defaults body Expr Str Return Call NameLoad NameLoad NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad NameLoad NameLoad kwarg body Expr Str Assign NameStore Call NameLoad If CompareIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad Assign NameStore Str If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad If NameLoad body If Call NameLoad NameLoad NameLoad body Assign NameStore ListLoad NameLoad If Call NameLoad NameLoad NameLoad body AugAssignAdd NameStore Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse Raise Call NameLoad Str Assign NameStore Call NameLoad If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad orelse AugAssignAdd NameStore BinOpAdd Str NameLoad If CompareIs NameLoad NameLoad body AugAssignAdd NameStore Str If NameLoad body If UnaryOpNot Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad If CompareEq SubscriptLoad NameLoad Index Str Num body Return NameLoad Return SubscriptLoad NameLoad Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad NameLoad NameLoad Str NameLoad NameLoad NameLoad NameLoad NameLoad kwarg body Expr Str If BoolOpOr BoolOpAnd NameLoad NameLoad BoolOpAnd UnaryOpNot NameLoad UnaryOpNot NameLoad body Raise Call NameLoad Str Assign NameStore Str Assign NameStore Call NameLoad Assign NameStore Call AttributeLoad Call NameLoad Str NameLoad Str attr If NameLoad body If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore BinOpAdd Str NameLoad orelse If NameLoad body If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore BinOpAdd Str NameLoad If BoolOpAnd NameLoad NameLoad body Raise Call NameLoad Str If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad orelse If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad Assign NameStore TupleLoad Str Str Str If BoolOpAnd NameLoad CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse AugAssignAdd NameStore BinOpAdd Str NameLoad Assign NameStore TupleLoad Str Str Str Str If BoolOpAnd NameLoad CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse AugAssignAdd NameStore BinOpAdd Str NameLoad If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad If NameLoad body If Call NameLoad NameLoad NameLoad body Assign NameStore ListLoad NameLoad If Call NameLoad NameLoad NameLoad body AugAssignAdd NameStore Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse Raise Call NameLoad Str If NameLoad body If UnaryOpNot Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad If NameLoad body If Call AttributeLoad NameLoad attr NameLoad body Raise Call NameLoad Str AugAssignAdd NameStore Call AttributeLoad Str attr NameLoad If CompareIs NameLoad NameLoad body AugAssignAdd NameStore Str Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad If CompareEq SubscriptLoad NameLoad Index Str Num body Return NameLoad Return SubscriptLoad NameLoad Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad kwarg body Expr Str Assign NameStore Str Assign NameStore TupleLoad Str Str Str If CompareIn NameLoad NameLoad body AugAssignAdd NameStore NameLoad orelse Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad If BoolOpOr BoolOpAnd NameLoad NameLoad BoolOpAnd UnaryOpNot NameLoad UnaryOpNot NameLoad body Raise Call NameLoad Str If NameLoad body If CompareEq NameLoad Str body Assign NameStore Str orelse If CompareEq NameLoad Str body Assign NameStore Str orelse If CompareEq NameLoad Str body Assign NameStore Str Assign NameStore Call NameLoad NameLoad If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore BinOpAdd Str NameLoad orelse If NameLoad body If UnaryOpNot Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad AugAssignAdd NameStore BinOpAdd Str NameLoad If BoolOpOr BoolOpAnd NameLoad NameLoad BoolOpAnd UnaryOpNot NameLoad UnaryOpNot NameLoad body Raise Call NameLoad Str If NameLoad body AugAssignAdd NameStore BinOpAdd Str NameLoad orelse If NameLoad body TryExcept body Expr Call AttributeLoad Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad Str attr Expr Call AttributeLoad NameLoad attr NameLoad AugAssignAdd NameStore BinOpAdd Str NameLoad handlers ExceptHandler type NameLoad body Raise Call NameLoad Call AttributeLoad Str attr NameLoad If NameLoad body Assign NameStore TupleLoad Str Str Str Str If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse AugAssignAdd NameStore BinOpAdd Str NameLoad Assign NameStore TupleLoad Str Str Str Str Str If BoolOpAnd NameLoad CompareNotIn NameLoad NameLoad body If UnaryOpNot Call AttributeLoad AttributeLoad NameLoad attr attr NameLoad body Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad orelse AugAssignAdd NameStore BinOpAdd Str NameLoad If NameLoad body AugAssignAdd NameStore Str Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad Assign NameStore Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad If CompareEq SubscriptLoad NameLoad Index Str Num body Return NameLoad Return SubscriptLoad NameLoad Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad Str body Expr Str Assign NameStore TupleLoad Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str Str If CompareNotIn NameLoad NameLoad body Raise Call NameLoad Call AttributeLoad Str attr Call AttributeLoad Str attr NameLoad Assign NameStore Str If CompareIs NameLoad NameLoad body Assign NameStore Str Assign NameStore Dict Assign NameStore NameLoad Assign NameStore Dict Assign NameStore Call AttributeLoad Str attr Call NameLoad NameLoad NameLoad For NameStore Call AttributeLoad Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr NameLoad attr body If UnaryOpNot Call AttributeLoad NameLoad attr body Continue Assign NameStore Call AttributeLoad NameLoad attr Str If CompareLt Call NameLoad NameLoad Num body Continue If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index NameLoad NameLoad Assign NameStore Call AttributeLoad Call AttributeLoad Str attr SubscriptLoad NameLoad Slice Num attr If CompareEq SubscriptLoad NameLoad Index Num NameLoad body Assign NameStore NameLoad Assign NameStore Dict Assign SubscriptStore NameLoad Index SubscriptLoad NameLoad Index Num NameLoad Return NameLoad decorator_list
N/A N/A 
Support for VirtualBox using the VBoxManage command

.. versionadded:: 2016.3.0

If the ``vboxdrv`` kernel module is not loaded, this module can automatically
load it by configuring ``autoload_vboxdrv`` in ``/etc/salt/minion``:

.. code-block: yaml

    autoload_vboxdrv: True

The default for this setting is ``False``.

:depends: virtualbox
 __future__ absolute_import N/A re N/A os.path N/A logging N/A salt.utils salt.ext.six string_types salt.exceptions CommandExecutionError N/A LOG N/A N/A logging getLogger __name__ N/A UUID_RE N/A N/A re compile N/A N/A [^{0}] format a-zA-Z0-9._- N/A NAME_RE N/A N/A re compile N/A N/A [^{0}] format a-zA-Z0-9._- __virtual__ N/A N/A N/A N/A N/A 
    Only load the module if VBoxManage is installed
     N/A N/A vboxcmd N/A N/A N/A N/A N/A __opts__ get autoload_vboxdrv False True N/A N/A N/A N/A N/A __salt__ N/A kmod.is_loaded vboxdrv N/A N/A N/A N/A __salt__ N/A kmod.load vboxdrv N/A True N/A N/A False The vboxmanaged execution module failed to load: VBoxManage is not installed. N/A vboxcmd N/A N/A N/A N/A N/A 
    Return the location of the VBoxManage command
     N/A N/A N/A N/A salt utils which VBoxManage N/A list_ostypes N/A N/A N/A N/A N/A 
    List the available OS Types
     N/A N/A list_items ostypes True ID N/A list_nodes_min N/A N/A N/A N/A N/A 
    Return a list of registered VMs, with minimal information
     N/A ret N/A N/A cmd N/A N/A {0} list vms format N/A vboxcmd N/A line N/A N/A N/A N/A N/A N/A salt modules cmdmod run cmd splitlines N/A N/A N/A N/A N/A line strip N/A N/A N/A comps N/A N/A line split N/A name N/A N/A N/A comps N/A 0 replace " N/A N/A ret N/A name True N/A ret N/A list_nodes_full N/A N/A N/A N/A N/A 
    Return a list of registered VMs, with detailed information
     N/A N/A list_items vms True Name N/A list_nodes N/A N/A N/A N/A N/A 
    Return a list of registered VMs
     N/A ret N/A N/A nodes N/A list_nodes_full N/A node nodes N/A N/A N/A ret N/A node N/A id image name state private_ips public_ips N/A N/A nodes N/A node N/A UUID N/A N/A nodes N/A node N/A Guest OS N/A N/A nodes N/A node N/A Name None N/A N/A N/A N/A N/A ret N/A node N/A size N/A N/A {0} RAM, {1} CPU format N/A N/A nodes N/A node N/A Memory size N/A N/A nodes N/A node N/A Number of CPUs N/A ret N/A start N/A N/A name N/A N/A N/A 
    Start a VM
     N/A ret N/A N/A cmd N/A N/A {0} startvm {1} format N/A vboxcmd name N/A ret N/A N/A N/A N/A N/A N/A salt modules cmdmod run cmd splitlines N/A ret N/A stop N/A N/A name N/A N/A N/A 
    Stop a VM
     N/A cmd N/A N/A {0} controlvm {1} poweroff format N/A vboxcmd name N/A ret N/A N/A N/A N/A N/A N/A salt modules cmdmod run cmd splitlines N/A ret N/A register N/A N/A filename N/A N/A N/A 
    Register a VM
     N/A N/A N/A N/A N/A os path isfile filename N/A N/A N/A CommandExecutionError N/A N/A The specified filename ({0}) does not exist. format filename N/A cmd N/A N/A {0} registervm {1} format N/A vboxcmd filename N/A ret N/A N/A N/A N/A salt modules cmdmod run_all cmd N/A N/A N/A ret N/A retcode 0 N/A N/A True N/A N/A ret N/A stderr N/A unregister N/A N/A name delete N/A False N/A N/A 
    Unregister a VM
     N/A nodes N/A list_nodes_min N/A N/A name nodes N/A N/A N/A CommandExecutionError N/A N/A The specified VM ({0}) is not registered. format name N/A cmd N/A N/A {0} unregistervm {1} format N/A vboxcmd name N/A N/A delete True N/A N/A cmd  --delete N/A ret N/A N/A N/A N/A salt modules cmdmod run_all cmd N/A N/A N/A ret N/A retcode 0 N/A N/A True N/A N/A ret N/A stderr N/A destroy N/A N/A name N/A N/A N/A 
    Unregister and destroy a VM
     N/A N/A unregister name True N/A create N/A N/A name groups ostype register basefolder new_uuid N/A None None True None None kwargs N/A N/A 
    Create a new VM

    CLI Example:

    .. code-block:: bash

        salt 'hypervisor' vboxmanage.create <name>
     N/A nodes N/A list_nodes_min N/A N/A name nodes N/A N/A N/A CommandExecutionError N/A N/A The specified VM ({0}) is already registered. format name N/A params N/A name N/A N/A N/A N/A NAME_RE search name N/A N/A N/A CommandExecutionError New VM name contains invalid characters N/A params N/A N/A  --name {0} format name N/A groups N/A N/A N/A isinstance groups string_types N/A N/A groups N/A groups N/A N/A isinstance groups list N/A N/A params N/A N/A  --groups {0} format N/A N/A , join groups N/A N/A N/A CommandExecutionError groups must be either a string or a list of strings N/A ostypes N/A list_ostypes N/A N/A ostype ostypes N/A N/A N/A CommandExecutionError N/A N/A The specified OS type ({0}) is not available. format name N/A N/A params N/A  --ostype  ostype N/A N/A register True N/A N/A params  --register N/A basefolder N/A N/A N/A N/A N/A N/A os path exists basefolder N/A N/A N/A CommandExecutionError N/A N/A basefolder {0} was not found format basefolder N/A params N/A N/A  --basefolder {0} format basefolder N/A new_uuid N/A N/A N/A N/A NAME_RE search new_uuid N/A N/A N/A CommandExecutionError New UUID contains invalid characters N/A params N/A N/A  --uuid {0} format new_uuid N/A cmd N/A N/A {0} create {1} format N/A vboxcmd params N/A ret N/A N/A N/A N/A salt modules cmdmod run_all cmd N/A N/A N/A ret N/A retcode 0 N/A N/A True N/A N/A ret N/A stderr N/A clonevm N/A N/A name uuid new_name snapshot_uuid snapshot_name mode options basefolder new_uuid register groups N/A None None None None None machine None None None False None kwargs N/A N/A 
    Clone a new VM from an existing VM

    CLI Example:

    .. code-block:: bash

        salt 'hypervisor' vboxmanage.clonevm <name> <new_name>
     N/A N/A N/A name uuid N/A N/A name N/A uuid N/A N/A N/A CommandExecutionError Either a name or a uuid must be specified, but not both. N/A params N/A nodes_names N/A list_nodes_min N/A nodes_uuids N/A N/A N/A list_items vms True UUID keys N/A name N/A N/A N/A name nodes_names N/A N/A N/A CommandExecutionError N/A N/A The specified VM ({0}) is not registered. format name N/A params N/A name N/A N/A uuid N/A N/A N/A uuid nodes_uuids N/A N/A N/A CommandExecutionError N/A N/A The specified VM ({0}) is not registered. format name N/A params N/A uuid N/A N/A snapshot_name snapshot_uuid N/A N/A N/A CommandExecutionError Either a snapshot_name or a snapshot_uuid may be specified, but not both N/A snapshot_name N/A N/A N/A N/A NAME_RE search snapshot_name N/A N/A N/A CommandExecutionError Snapshot name contains invalid characters N/A params N/A N/A  --snapshot {0} format snapshot_name N/A N/A snapshot_uuid N/A N/A N/A N/A UUID_RE search snapshot_uuid N/A N/A N/A CommandExecutionError Snapshot name contains invalid characters N/A params N/A N/A  --snapshot {0} format snapshot_uuid N/A valid_modes N/A machine machineandchildren all N/A N/A mode N/A mode valid_modes N/A N/A N/A CommandExecutionError N/A N/A Mode must be one of: {0} (default "machine") format N/A N/A ,  join valid_modes N/A N/A params N/A  --mode  mode N/A valid_options N/A link keepallmacs keepnatmacs keepdisknames N/A N/A options N/A options valid_options N/A N/A N/A CommandExecutionError N/A N/A If specified, options must be one of: {0} format N/A N/A ,  join valid_options N/A N/A params N/A  --options  options N/A new_name N/A N/A N/A N/A NAME_RE search new_name N/A N/A N/A CommandExecutionError New name contains invalid characters N/A params N/A N/A  --name {0} format new_name N/A groups N/A N/A N/A isinstance groups string_types N/A N/A groups N/A groups N/A N/A isinstance groups list N/A N/A params N/A N/A  --groups {0} format N/A N/A , join groups N/A N/A N/A CommandExecutionError groups must be either a string or a list of strings N/A basefolder N/A N/A N/A N/A N/A N/A os path exists basefolder N/A N/A N/A CommandExecutionError N/A N/A basefolder {0} was not found format basefolder N/A params N/A N/A  --basefolder {0} format basefolder N/A new_uuid N/A N/A N/A N/A NAME_RE search new_uuid N/A N/A N/A CommandExecutionError New UUID contains invalid characters N/A params N/A N/A  --uuid {0} format new_uuid N/A N/A register True N/A N/A params  --register N/A cmd N/A N/A {0} clonevm {1} format N/A vboxcmd name N/A ret N/A N/A N/A N/A salt modules cmdmod run_all cmd N/A N/A N/A ret N/A retcode 0 N/A N/A True N/A N/A ret N/A stderr N/A clonemedium N/A N/A medium uuid_in file_in uuid_out file_out mformat variant existing N/A None None None None None None False kwargs N/A N/A 
    Clone a new VM from an existing VM

    CLI Example:

    .. code-block:: bash

        salt 'hypervisor' vboxmanage.clonemedium <name> <new_name>
     N/A params N/A valid_mediums N/A disk dvd floppy N/A N/A medium valid_mediums N/A N/A params medium N/A N/A N/A CommandExecutionError N/A N/A Medium must be one of: {0}. format N/A N/A ,  join valid_mediums N/A N/A N/A uuid_in file_in N/A N/A uuid_in N/A file_in N/A N/A N/A CommandExecutionError Either uuid_in or file_in must be used, but not both. N/A uuid_in N/A N/A N/A medium disk N/A N/A item hdds N/A N/A N/A medium dvd N/A N/A item dvds N/A N/A N/A medium floppy N/A N/A item floppies N/A items N/A list_items item N/A N/A uuid_in items N/A N/A N/A CommandExecutionError N/A N/A UUID {0} was not found format uuid_in N/A params N/A uuid_in N/A N/A file_in N/A N/A N/A N/A N/A N/A os path exists file_in N/A N/A N/A CommandExecutionError N/A N/A File {0} was not found format file_in N/A params N/A file_in N/A N/A N/A uuid_out file_out N/A N/A uuid_out N/A file_out N/A N/A N/A CommandExecutionError Either uuid_out or file_out must be used, but not both. N/A uuid_out N/A N/A params N/A uuid_out N/A N/A file_out N/A N/A N/A N/A N/A N/A N/A N/A N/A salt utils fopen file_out w close N/A N/A N/A os unlink file_out N/A params N/A file_out N/A N/A N/A OSError N/A N/A N/A CommandExecutionError N/A N/A {0} is not a valid filename format file_out N/A mformat N/A N/A valid_mformat N/A VDI VMDK VHD RAW N/A N/A mformat valid_mformat N/A N/A N/A CommandExecutionError N/A N/A If specified, mformat must be one of: {0} format N/A N/A ,  join valid_mformat N/A N/A params N/A  --format  mformat N/A valid_variant N/A Standard Fixed Split2G Stream ESX N/A N/A variant N/A variant valid_variant N/A N/A N/A N/A N/A N/A os path exists file_in N/A N/A N/A CommandExecutionError N/A N/A If specified, variant must be one of: {0} format N/A N/A ,  join valid_variant N/A N/A params N/A  --variant  variant N/A existing N/A N/A params  --existing N/A cmd N/A N/A {0} clonemedium {1} format N/A vboxcmd params N/A ret N/A N/A N/A N/A salt modules cmdmod run_all cmd N/A N/A N/A ret N/A retcode 0 N/A N/A True N/A N/A ret N/A stderr N/A list_items N/A N/A item details group_by N/A False UUID N/A N/A 
    Return a list of a specific type of item. The following items are available:

        vms
        runningvms
        ostypes
        hostdvds
        hostfloppies
        intnets
        bridgedifs
        hostonlyifs
        natnets
        dhcpservers
        hostinfo
        hostcpuids
        hddbackends
        hdds
        dvds
        floppies
        usbhost
        usbfilters
        systemproperties
        extpacks
        groups
        webcams
        screenshotformats

    CLI Example:

    .. code-block:: bash

        salt 'hypervisor' vboxmanage.items <item>
        salt 'hypervisor' vboxmanage.items <item> details=True
        salt 'hypervisor' vboxmanage.items <item> details=True group_by=Name

    Some items do not display well, or at all, unless ``details`` is set to
    ``True``. By default, items are grouped by the ``UUID`` field, but not all
    items contain that field. In those cases, another field must be specified.
     N/A types N/A vms runningvms ostypes hostdvds hostfloppies intnets bridgedifs hostonlyifs natnets dhcpservers hostinfo hostcpuids hddbackends hdds dvds floppies usbhost usbfilters systemproperties extpacks groups webcams screenshotformats N/A N/A item types N/A N/A N/A CommandExecutionError N/A N/A Item must be one of: {0}. format N/A N/A ,  join types N/A flag N/A N/A details True N/A N/A flag  -l N/A ret N/A N/A tmp_id None N/A tmp_dict N/A N/A cmd N/A N/A {0} list{1} {2} format N/A vboxcmd flag item N/A line N/A N/A N/A N/A N/A N/A salt modules cmdmod run cmd splitlines N/A N/A N/A N/A N/A line strip N/A N/A N/A comps N/A N/A line split : N/A N/A N/A len comps 1 N/A N/A N/A N/A tmp_id None N/A N/A N/A ret N/A tmp_id tmp_dict N/A line_val N/A N/A N/A N/A : join N/A comps N/A 1 strip N/A N/A N/A comps N/A 0 group_by N/A N/A tmp_id line_val N/A tmp_dict N/A N/A N/A tmp_dict N/A N/A comps N/A 0 line_val N/A ret N/A