reqd params : uuid
optional params : database:
description : Test whether storage is available to recover this VM appliance.
reqd params : name-label
optional params : name-description
description : Create a VM appliance.
reqd params : uuid
optional params :
description : Destroy a VM appliance.
reqd params :
optional params : params, database:, uuid, name-label, name-description, VMs, allowed-operations, current-operations, VMs:contains, allowed-operations:contains, current-operations:contains
description : Lists all the appliances, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,VMs,allowed-operations,current-operations).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params : name-label, name-description
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params : database:, force
description : Recover a VM appliance from the database contained in the supplied VDI.
reqd params : uuid
optional params : force
description : Shut down all VMs in a VM appliance.
reqd params : uuid
optional params : paused
description : Start a VM appliance.
reqd params : filename
optional params : since
description : Write the audit log of the pool to <filename>
reqd params : network-uuid, pif-uuids
optional params : mac, mode, properties:
description : Create a bonded interface from a list of existing PIF objects.
reqd params : uuid
optional params :
description : Destroy a bonded interface.
reqd params :
optional params : params, database:, uuid, master, slaves, mode, properties, primary-slave, links-up
description : Lists all the bonds, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be properties).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params : properties:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid, mode
optional params :
description : Change the bond mode.
reqd params :
optional params : params
description : List the CDs available to be attached to VMs.
reqd params :
optional params : <vm-selectors>
description : Attach to a particular console. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : params, database:, uuid, vm-uuid, vm-name-label, protocol, location, other-config
description : Lists all the consoles, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params :
description : Perform a major GC collection and heap compaction.
reqd params :
optional params :
description : Start logging the database operations. Warning: once started, this cannot be stopped.
reqd params :
optional params :
description : Print db stats.
reqd params :
optional params :
description : Print GC stats.
reqd params :
optional params :
description : Help diagnose pool-wide licensing problems.
reqd params :
optional params : uri, method, params
description : Print network stats.
reqd params :
optional params :
description : Print timing stats.
reqd params : uuid
optional params :
description : Query the locking and sharing status of a VDI.
reqd params : uuid
optional params :
description : Query the hosts on which the VM can boot, check the sharing/locking status of all VBDs.
reqd params : type
optional params : device-config:, sr-whitelist
description : Create a disaster recovery task.
reqd params : uuid
optional params :
description : Destroy a disaster recovery task.
reqd params :
optional params : params, database:, uuid, introduced-SRs
description : Lists all the drtasks, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : class
optional params :
description : Wait for the event that satisfies the conditions given on the command line.
reqd params : name-label
optional params : name-description
description : Create an empty GPU group
reqd params : uuid
optional params :
description : Destroy a GPU group
reqd params : uuid, vgpu-type-uuid
optional params :
description : Calculate the number of VGPUs of the specified type which still be started in the group
reqd params :
optional params : params, database:, uuid, name-label, name-description, VGPU-uuids, PGPU-uuids, other-config, enabled-VGPU-types, supported-VGPU-types, allocation-algorithm, VGPU-uuids:contains, PGPU-uuids:contains
description : Lists all the gpu-groups, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,VGPU-uuids,PGPU-uuids,other-config,allocation-algorithm).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, allocation-algorithm, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params :
description : Get a list of all available editions.
reqd params : edition
optional params : host-uuid, license-server-address, license-server-port
description : Change to another edition, or reactivate the current edition after a license has expired. This may be subject to the successful checkout of an appropriate license.
reqd params : file-name
optional params : <host-selectors>
description : Download a backup of the host’s control domain. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : url, http_proxy, <host-selectors>
description : Upload the output of xen-bugtool –yestoall on a specific host to the support website. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : host-uuid, plugin, fn
optional params : args:
description : Calls the function within the plugin on the given host with optional arguments.
reqd params :
optional params : <host-selectors>
description : Computes the amount of free memory on the host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : Computes the virtualization memory overhead of a host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : uuid
description : Lists information about the host’s physical CPUs.
reqd params :
optional params : params, database:, uuid, host-uuid, number, vendor, speed, model, family, modelname, stepping, flags, utilisation
description : Lists all the host-cpus, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params :
description : Delete a host crashdump from the server.
reqd params :
optional params : params, database:, uuid, host-uuid, timestamp, size
description : Lists all the host-crashdumps, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params : url, http_proxy
description : Upload a host crash dump to the support website.
reqd params : data-source
optional params : <host-selectors>
description : Stop recording the specified data source for a Host, and forget all of the recorded data. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : List the data sources that can be recorded for a Host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : data-source
optional params : <host-selectors>
description : Query the last value read from a Host data source. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : data-source
optional params : <host-selectors>
description : Record the specified data source for a Host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Declare that the the host is dead without contacting it explicitly. WARNING: This call is dangerous and can cause data loss if the host is not actually dead
reqd params :
optional params : <host-selectors>
description : Disable the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Disable display for the host
reqd params :
optional params : <host-selectors>
description : Disable local storage caching on the specified host The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : Get xen dmesg of the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : force
description : Disable HA on the local host. Only to be used to recover a pool with a broken HA setup.
reqd params : interface
optional params :
description : Reconfigure the management interface of this node: only use if the node is in emergency mode.
reqd params :
optional params : <host-selectors>
description : Enable the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Enable display for the host
reqd params : sr-uuid
optional params : <host-selectors>
description : Enable local storage caching on the specified host The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : Migrate all VMs off a host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Forget about the host without contacting it explicitly. WARNING: this call is useful if the host to ‘forget’ is dead; however, if the host is live and part of the pool, you should consider using pool-eject instead.
reqd params :
optional params : uuid
description : Prints a hexadecimal representation of the host’s physical-CPU features.
reqd params :
optional params : <host-selectors>
description : Get the installed server SSL certificate. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Display per-host SM diagnostic information.
reqd params : filename
optional params : entries, output, <host-selectors>
description : Download system status into <filename>. Entries is a comma-separated list. Output may be ‘tar’, ‘tar.bz2’ (the default) or ‘zip’. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : uuid
optional params :
description : Display per-host thread diagnostic information.
reqd params : uuid
optional params :
description : Return a list of VMs which prevent the evacuation of a specific host and display reasons for each one.
reqd params :
optional params :
description : Query the target host to discover if it is in emergency mode.
reqd params : license-file
optional params : host-uuid
description : Add a license to a host.
reqd params :
optional params : host-uuid
description : Remove any licensing applied to a host.
reqd params :
optional params : host-uuid
description : View the license parameters of the host.
reqd params :
optional params : params, database:, uuid, name-label, name-description, allowed-operations, current-operations, enabled, display, API-version-major, API-version-minor, API-version-vendor, API-version-vendor-implementation, logging, suspend-image-sr-uuid, crash-dump-sr-uuid, software-version, capabilities, other-config, cpu_info, chipset-info, hostname, address, supported-bootloaders, blobs, memory-overhead, memory-total, memory-free, memory-free-computed, host-metrics-live, patches, ha-statefiles, ha-network-peers, external-auth-type, external-auth-service-name, external-auth-configuration, edition, license-server, power-on-mode, power-on-config, local-cache-sr, tags, ssl-legacy, guest_VCPUs_params, virtual-hardware-platform-versions, allowed-operations:contains, current-operations:contains, capabilities:contains, supported-bootloaders:contains, patches:contains, tags:contains, virtual-hardware-platform-versions:contains
description : Lists all the hosts, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params :
optional params : file-name, <host-selectors>
description : Download a copy of the host logs. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params :
description : Disable the management interface of this node.
reqd params : pif-uuid
optional params :
description : Reconfigure the management interface of this node.
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,allowed-operations,current-operations,API-version-vendor-implementation,logging,suspend-image-sr-uuid,crash-dump-sr-uuid,software-version,capabilities,other-config,cpu_info,chipset-info,supported-bootloaders,patches,external-auth-configuration,license-server,power-on-config,tags,ssl-legacy,guest_VCPUs_params,virtual-hardware-platform-versions).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, suspend-image-sr-uuid, crash-dump-sr-uuid, ssl-legacy, logging:, other-config:, guest_VCPUs_params:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params : <host-selectors>
description : Power on the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : Reboot the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : file-name
optional params : <host-selectors>
description : Upload a backup of the host’s control domain. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : host-uuid, keys
optional params :
description : Send specified hypervisor debug keys to specified host
reqd params : host-uuid, host-name
optional params : <host-selectors>
description : Sets the host name to the specified string. Both the API and lower-level system hostname are changed. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : power-on-mode
optional params : power-on-config, <host-selectors>
description : Sets the power-on mode for the XE host The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params : <host-selectors>
description : Shutdown the XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params :
optional params :
description : Shut down the agent on the local host.
reqd params : uuid, dp
optional params : allow-leak
description : Attempt to destroy and clean up a storage datapath on a host. If allow-leak=true is provided then it will delete all records of the datapath even if it could not be shutdown cleanly.
reqd params :
optional params : <host-selectors>
description : Synchronise the non-database data stored on the pool master with the named XE host. The simplest way to select the host on which the operation is to be performed is by supplying the argument ‘host=<name or uuid>’. Hosts can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple hosts are matching, and the operation can be performed on multiple hosts, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe host-list params=all’. If no parameters to select hosts are given, the operation will be performed on all hosts.
reqd params : host-uuid
optional params :
description : Reconfigure syslog daemon.
reqd params :
optional params :
description : Return the log currently stored in the string logger.
reqd params :
optional params :
description : List the keys known by the logger.
reqd params :
optional params :
description : Reopen all loggers (use this for rotating files).
reqd params : output
optional params : key, level
description : Set all loggers to the specified output (nil, stderr, string, file:<filename>, syslog:<something>).
reqd params : sr-uuid, initial-allocation, allocation-quantum
optional params :
description : Enable thin-provisioning on an LVHD SR.
reqd params : name, priority, body
optional params : vm-uuid, host-uuid, sr-uuid, pool-uuid
description : Create a message associated with a particular API object. Note exactly one of the optional parameters must be supplied.
reqd params : uuid
optional params :
description : Destroy an existing message.
reqd params :
optional params : params, database:, uuid, name, priority, class, obj-uuid, timestamp, body
description : Lists all the messages, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : name-label
optional params : name-description, MTU
description : Create a new network.
reqd params : uuid
optional params :
description : Delete an existing network.
reqd params :
optional params : params, database:, uuid, name-label, name-description, VIF-uuids, PIF-uuids, MTU, bridge, other-config, blobs, tags, default-locking-mode, VIF-uuids:contains, PIF-uuids:contains, tags:contains
description : Lists all the networks, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,VIF-uuids,PIF-uuids,MTU,other-config,tags,default-locking-mode).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, MTU, default-locking-mode, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid, host-uuid
optional params :
description : Apply the previously uploaded patch to the specified host.
reqd params : uuid
optional params :
description : Delete a previously uploaded patch file.
reqd params : uuid
optional params :
description : Remove an unapplied patch record and files from the server.
reqd params :
optional params : params, database:, uuid, name-label, name-description, size, hosts, after-apply-guidance, hosts:contains, after-apply-guidance:contains
description : Lists all the patches, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be hosts,after-apply-guidance).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params :
description : Apply the previously uploaded patch to all hosts in the pool.
reqd params : uuid
optional params :
description : Delete a previously uploaded patch file on all hosts in the pool.
reqd params : uuid, host-uuid
optional params :
description : Run the prechecks contained within the patch previously uploaded to the specified host.
reqd params : file-name
optional params :
description : Upload a patch file to the server.
reqd params : host-uuid, sr-uuid
optional params : device-config:
description : Create a PBD. The read-only device-config parameter can only be set on creation in the following manner. To
add a mapping of ‘path’ -> ‘/tmp’, the command line should contain the argument device-config:path=/tmp
reqd params : uuid
optional params :
description : Destroy the PBD.
reqd params :
optional params : params, database:, uuid, host, host-uuid, host-name-label, sr-uuid, sr-name-label, device-config, currently-attached, other-config
description : Lists all the pbds, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be device-config,other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params :
description : Attempt to plug in the PBD to the host. If this succeeds then the referenced SR (and the VDIs contained within) should be visible to the host.
reqd params : uuid
optional params :
description : Attempt to unplug the PBD from the host. If this succeeds then the referenced SR (and the VDIs contained within) should not be visible to the host.
reqd params : uuid
optional params :
description : Disable PGPU access to dom0.
reqd params : uuid
optional params :
description : Enable PGPU access to dom0.
reqd params :
optional params : params, database:, uuid, vendor-name, device-name, dom0-access, is-system-display-device, gpu-group-uuid, gpu-group-name-label, host-uuid, host-name-label, pci-id, dependencies, other-config, supported-VGPU-types, enabled-VGPU-types, resident-VGPUs, dependencies:contains, enabled-VGPU-types:contains
description : Lists all the pgpus, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be gpu-group-uuid,dependencies,other-config,enabled-VGPU-types).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : gpu-group-uuid, enabled-VGPU-types, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params :
description : Destroy a PIF object on a particular host.
reqd params : host-uuid, device
optional params : mac, managed
description : Create a new PIF object representing a physical interface on a host.
reqd params :
optional params : params, database:, uuid, device, MAC, physical, managed, currently-attached, MTU, VLAN, bond-master-of, bond-slave-of, tunnel-access-PIF-of, tunnel-transport-PIF-of, management, network-uuid, network-name-label, host-uuid, host-name-label, IP-configuration-mode, IP, netmask, gateway, IPv6-configuration-mode, IPv6, IPv6-gateway, primary-address-type, DNS, properties, capabilities, io_read_kbs, io_write_kbs, carrier, vendor-id, vendor-name, device-id, device-name, speed, duplex, disallow-unplug, pci-bus-path, other-config, capabilities:contains
description : Lists all the pifs, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be properties,capabilities,disallow-unplug,other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : disallow-unplug, other-config:, properties:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params :
description : Attempt to bring up a network interface.
reqd params : uuid, mode
optional params : IP, netmask, gateway, DNS
description : Reconfigure the IP address settings on a PIF.
reqd params : uuid, mode
optional params : IPv6, gateway, DNS
description : Reconfigure the IPv6 address settings on a PIF.
reqd params : host-uuid
optional params :
description : Scan for new physical interfaces on a host.
reqd params : uuid, primary_address_type
optional params :
description : Change the primary address type used by this PIF.
reqd params : uuid
optional params :
description : Attempt to bring down a network interface.
reqd params : edition
optional params : uuid, license-server-address, license-server-port
description : Apply an edition across the pool
reqd params : filename
optional params :
description : Install an SSL certificate, pool-wide.
reqd params :
optional params :
description : List all installed SSL certificates.
reqd params :
optional params :
description : Sync SSL certificates and certificate revocation lists from master to slaves.
reqd params : name
optional params :
description : Uninstall an SSL certificate.
reqd params : filename
optional params :
description : Install an SSL certificate revocation list, pool-wide.
reqd params :
optional params :
description : List all installed SSL certificate revocation lists.
reqd params : name
optional params :
description : Uninstall an SSL certificate revocation list.
reqd params :
optional params :
description : Permanently remove the configuration for workload balancing
reqd params : host-uuid
optional params :
description : Request an orderly handover of the role of master to another host.
reqd params :
optional params : uuid, config:
description : Disables external authentication in all the hosts in a pool
reqd params : uuid
optional params :
description : Disable local storage caching across the pool
reqd params :
optional params :
description : Disable the redo log if in use, unless HA is enabled.
reqd params :
optional params : uuid
description : Set ssl-legacy to False on each host.
reqd params : file-name
optional params :
description : Download a dump of the pool database.
reqd params : host-uuid
optional params :
description : Instruct host to leave an existing pool.
reqd params : master-address
optional params :
description : Instruct slave to reset master address.
reqd params :
optional params :
description : Instruct slave to become pool master.
reqd params : auth-type, service-name
optional params : uuid, config:
description : Enables external authentication in all the hosts in a pool. Note that some values of auth-type will require particular config: values.
reqd params : uuid
optional params :
description : Enable local storage caching across the pool
reqd params : sr-uuid
optional params :
description : Enable the redo log on the given SR and start using it, unless HA is enabled.
reqd params :
optional params : uuid
description : Set ssl-legacy to True on each host.
reqd params :
optional params : vm-uuid, restart-priority
description : Compute the maximum number of host failures to tolerate with the supplied, proposed protected VMs.
reqd params :
optional params :
description : Compute the maximum number of host failures to tolerate under the current Pool configuration
reqd params :
optional params :
description : Disable HA on this Pool.
reqd params :
optional params : heartbeat-sr-uuids, ha-config:
description : Enable HA on this Pool.
reqd params : wlb_url, wlb_username, wlb_password, xenserver_username, xenserver_password
optional params :
description : Initialize workload balancing for the current pool with the target wlb server
reqd params : master-address, master-username, master-password
optional params : force
description : Instruct host to join an existing pool.
reqd params :
optional params : params, database:, uuid, name-label, name-description, master, default-SR, crash-dump-SR, suspend-image-SR, supported-sr-types, other-config, allowed-operations, current-operations, ha-enabled, ha-configuration, ha-statefiles, ha-host-failures-to-tolerate, ha-plan-exists-for, ha-allow-overcommit, ha-overcommitted, blobs, wlb-url, wlb-username, wlb-enabled, wlb-verify-cert, gui-config, health-check-config, restrictions, tags, license-state, ha-cluster-stack, guest-agent-config, cpu_info, policy-no-vendor-device, allowed-operations:contains, current-operations:contains, tags:contains
description : Lists all the pools, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,default-SR,crash-dump-SR,suspend-image-SR,other-config,allowed-operations,current-operations,ha-host-failures-to-tolerate,ha-allow-overcommit,wlb-enabled,wlb-verify-cert,gui-config,health-check-config,tags,guest-agent-config,cpu_info,policy-no-vendor-device).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, default-SR, crash-dump-SR, suspend-image-SR, ha-host-failures-to-tolerate, ha-allow-overcommit, wlb-enabled, wlb-verify-cert, policy-no-vendor-device, other-config:, gui-config:, health-check-config:, guest-agent-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params :
description : Instruct master to try and reset master-address of all slaves currently running in emergency mode.
reqd params : file-name
optional params : dry-run
description : Restore a dump of the pool database to the server.
reqd params :
optional params :
description : Retrieves the pool optimization criteria from the workload balancing server
reqd params :
optional params : filename
description :
reqd params :
optional params :
description : Retrieves vm migrate recommendations for the pool from the workload balancing server
reqd params : report
optional params : filename
description :
reqd params : dest-host, dest-port, body
optional params :
description : Send the given body to the given host and port, using HTTPS, and print the response. This is used for debugging the SSL layer.
reqd params :
optional params : config:
description : Sets the pool optimization criteria for the workload balancing server
reqd params :
optional params :
description : Synchronise the current database across all hosts in the pool.
reqd params : pif-uuid, vlan, network-uuid
optional params :
description : Create a new VLAN on each host in a pool.
reqd params :
optional params : params, database:, uuid, name, description
description : Lists all the roles, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : value
optional params :
description : Create a secret
reqd params : uuid
optional params :
description : Destroy a secret
reqd params :
optional params : params, database:, uuid, value
description : Lists all the secrets, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be value).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params : value
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params :
description : Return a list of all the user subject ids of all externally-authenticated existing sessions
reqd params : subject-identifier
optional params :
description : Log out all externally-authenticated sessions associated to a user subject id
reqd params :
optional params :
description : Log out all externally-authenticated sessions
reqd params :
optional params : params, database:, uuid, name-label, name-description, type, vendor, copyright, required-api-version, capabilities, features, configuration, driver-filename, required-cluster-stack
description : Lists all the sms, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be features).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : new-name-label
optional params : uuid, new-name-description
description : Create a new template by cloning an existing snapshot, using storage-level fast disk clone operation where available.
reqd params : new-name-label
optional params : uuid, new-name-description, sr-uuid
description : Create a new template by copying an existing VM, but without using storage-level fast disk clone operation (even if this is available). The disk images of the copied VM are guaranteed to be ‘full images’ – i.e. not part of a CoW chain.
reqd params :
optional params : uuid, snapshot-uuid
description : Destroy a snapshot. This leaves the storage associated with the snapshot intact. To delete storage too, use snapshot-uninstall.
reqd params :
optional params : uuid, snapshot-uuid, vbd-params, vdi-params, <vm-selectors>
description : List the disks on the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : filename, snapshot-uuid
optional params : preserve-power-state
description : Export a snapshot to <filename>.
reqd params :
optional params : params, database:, uuid, name-label, name-description, user-version, is-a-template, is-a-snapshot, snapshot-of, snapshots, snapshot-time, snapshot-info, parent, children, is-control-domain, power-state, memory-actual, memory-target, memory-overhead, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-params, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, console-uuids, platform, allowed-operations, current-operations, blocked-operations, allowed-VBD-devices, allowed-VIF-devices, possible-hosts, HVM-boot-policy, HVM-boot-params, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, last-boot-CPU-flags, last-boot-record, resident-on, affinity, other-config, dom-id, recommendations, xenstore-data, ha-always-run, ha-restart-priority, blobs, start-time, install-time, VCPUs-number, VCPUs-utilisation, os-version, PV-drivers-version, PV-drivers-up-to-date, memory, disks, networks, PV-drivers-detected, other, live, guest-metrics-last-updated, can-use-hotplug-vbd, can-use-hotplug-vif, cooperative, tags, appliance, start-delay, shutdown-delay, order, version, generation-id, hardware-platform-version, has-vendor-device, console-uuids:contains, allowed-operations:contains, current-operations:contains, allowed-VBD-devices:contains, allowed-VIF-devices:contains, tags:contains
description : Lists all the snapshots, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,user-version,is-a-template,memory-static-max,memory-dynamic-max,memory-dynamic-min,memory-static-min,suspend-VDI-uuid,suspend-SR-uuid,VCPUs-params,VCPUs-max,VCPUs-at-startup,actions-after-shutdown,actions-after-reboot,actions-after-crash,console-uuids,platform,allowed-operations,current-operations,blocked-operations,allowed-VBD-devices,allowed-VIF-devices,HVM-boot-policy,HVM-boot-params,HVM-shadow-multiplier,PV-kernel,PV-ramdisk,PV-args,PV-legacy-args,PV-bootloader,PV-bootloader-args,affinity,other-config,xenstore-data,ha-always-run,ha-restart-priority,VCPUs-utilisation,os-version,PV-drivers-version,memory,disks,networks,other,tags,appliance,start-delay,shutdown-delay,order,has-vendor-device).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, user-version, is-a-template, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, HVM-boot-policy, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, affinity, ha-always-run, ha-restart-priority, appliance, start-delay, shutdown-delay, order, has-vendor-device, VCPUs-params:, platform:, blocked-operations:, HVM-boot-params:, other-config:, xenstore-data:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params : uuid, snapshot-uuid, force, <vm-selectors>
description : Force the VM powerstate to halted in the management toolstack database only. This command is used to recover a snapshot that is marked as ‘suspended’. This is a potentially dangerous operation: you must ensure that you do not need the memory image anymore (ie. you will not be able to resume your snapshot anymore). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : uuid, snapshot-uuid
description : Revert an existing VM to a previous checkpointed or snapshotted state.
reqd params :
optional params : uuid, snapshot-uuid, force
description : Uninstall a snapshot. This operation will destroy those VDIs that are marked RW and connected to this snapshot only. To simply destroy the VM record, use snapshot-destroy.
reqd params : name-label, type
optional params : host-uuid, device-config:, shared, physical-size, content-type, sm-config:
description : Create an SR, also a PBD. the device-config parameters can be specified by e.g. device-config:foo=baa.
reqd params : data-source
optional params : <sr-selectors>
description : Stop recording the specified data source for a SR, and forget all of the recorded data. The simplest way to select the SR on which the operation is to be performed is by supplying the argument ‘sr=<name or uuid>’. SRs can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple SRs are matching, and the operation can be performed on multiple SRs, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe sr-list params=all’. If no parameters to select SRs are given, the operation will be performed on all SRs.
reqd params :
optional params : <sr-selectors>
description : List the data sources that can be recorded for a SR. The simplest way to select the SR on which the operation is to be performed is by supplying the argument ‘sr=<name or uuid>’. SRs can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple SRs are matching, and the operation can be performed on multiple SRs, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe sr-list params=all’. If no parameters to select SRs are given, the operation will be performed on all SRs.
reqd params : data-source
optional params : <sr-selectors>
description : Query the last value read from a SR data source. The simplest way to select the SR on which the operation is to be performed is by supplying the argument ‘sr=<name or uuid>’. SRs can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple SRs are matching, and the operation can be performed on multiple SRs, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe sr-list params=all’. If no parameters to select SRs are given, the operation will be performed on all SRs.
reqd params : data-source
optional params : <sr-selectors>
description : Record the specified data source for a SR. The simplest way to select the SR on which the operation is to be performed is by supplying the argument ‘sr=<name or uuid>’. SRs can also be specified by filtering the full list of hosts on the values of fields. For example, specifying ‘enabled=true’ will select all hosts whose ‘enabled’ field is equal to ‘true’. Where multiple SRs are matching, and the operation can be performed on multiple SRs, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe sr-list params=all’. If no parameters to select SRs are given, the operation will be performed on all SRs.
reqd params : uuid
optional params :
description : Destroy the SR.
reqd params : uuid
optional params :
description : Disable database replication to the SR.
reqd params : uuid
optional params :
description : Enable database replication to the SR.
reqd params : uuid
optional params :
description : Forget about the SR.
reqd params : name-label, type, uuid
optional params : shared, content-type
description : Introduces an SR (but does not create any PBDs).
reqd params :
optional params : params, database:, uuid, name-label, name-description, host, allowed-operations, current-operations, VDIs, PBDs, virtual-allocation, physical-utilisation, physical-size, type, content-type, shared, introduced-by, is-tools-sr, other-config, sm-config, blobs, local-cache-enabled, tags, clustered, allowed-operations:contains, current-operations:contains, VDIs:contains, PBDs:contains, tags:contains
description : Lists all the srs, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,allowed-operations,current-operations,VDIs,PBDs,shared,other-config,sm-config,tags).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, shared, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : type
optional params : host-uuid, device-config:, sm-config:
description : Perform a storage probe. The device-config parameters can be specified by e.g. device-config:devs=/dev/sdb1.
reqd params : uuid
optional params :
description : Force an SR scan, syncing database with VDIs present in underlying storage substrate.
reqd params : uuid
optional params :
description : Refresh the fields of the SR object in the database.
reqd params : subject-name
optional params :
description : Add a subject to the list of subjects that can access the pool
reqd params :
optional params : params, database:, uuid, subject-identifier, other-config, roles, roles:contains
description : Lists all the subjects, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be other-config,roles).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : subject-uuid
optional params :
description : Remove a subject from the list of subjects that can access the pool
reqd params : uuid
optional params : role-name, role-uuid
description : Add a role to a subject
reqd params : uuid
optional params : role-name, role-uuid
description : Remove a role from a subject
reqd params : uuid
optional params :
description : Set a task to cancelling and return.
reqd params :
optional params : params, database:, uuid, name-label, name-description, subtask_of, subtasks, resident-on, status, progress, type, result, created, finished, error_info, allowed_operations, other-config
description : Lists all the tasks, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : filename, template-uuid
optional params :
description : Export a template to <filename>.
reqd params :
optional params : params, database:, uuid, name-label, name-description, user-version, is-a-template, is-a-snapshot, snapshot-of, snapshots, snapshot-time, snapshot-info, parent, children, is-control-domain, power-state, memory-actual, memory-target, memory-overhead, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-params, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, console-uuids, platform, allowed-operations, current-operations, blocked-operations, allowed-VBD-devices, allowed-VIF-devices, possible-hosts, HVM-boot-policy, HVM-boot-params, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, last-boot-CPU-flags, last-boot-record, resident-on, affinity, other-config, dom-id, recommendations, xenstore-data, ha-always-run, ha-restart-priority, blobs, start-time, install-time, VCPUs-number, VCPUs-utilisation, os-version, PV-drivers-version, PV-drivers-up-to-date, memory, disks, networks, PV-drivers-detected, other, live, guest-metrics-last-updated, can-use-hotplug-vbd, can-use-hotplug-vif, cooperative, tags, appliance, start-delay, shutdown-delay, order, version, generation-id, hardware-platform-version, has-vendor-device, console-uuids:contains, allowed-operations:contains, current-operations:contains, allowed-VBD-devices:contains, allowed-VIF-devices:contains, tags:contains
description : Lists all the templates, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,user-version,is-a-template,memory-static-max,memory-dynamic-max,memory-dynamic-min,memory-static-min,suspend-VDI-uuid,suspend-SR-uuid,VCPUs-params,VCPUs-max,VCPUs-at-startup,actions-after-shutdown,actions-after-reboot,actions-after-crash,console-uuids,platform,allowed-operations,current-operations,blocked-operations,allowed-VBD-devices,allowed-VIF-devices,HVM-boot-policy,HVM-boot-params,HVM-shadow-multiplier,PV-kernel,PV-ramdisk,PV-args,PV-legacy-args,PV-bootloader,PV-bootloader-args,affinity,other-config,xenstore-data,ha-always-run,ha-restart-priority,VCPUs-utilisation,os-version,PV-drivers-version,memory,disks,networks,other,tags,appliance,start-delay,shutdown-delay,order,has-vendor-device).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, user-version, is-a-template, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, HVM-boot-policy, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, affinity, ha-always-run, ha-restart-priority, appliance, start-delay, shutdown-delay, order, has-vendor-device, VCPUs-params:, platform:, blocked-operations:, HVM-boot-params:, other-config:, xenstore-data:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : template-uuid
optional params : force
description : Uninstall a custom template. This operation will destroy those VDIs that are marked as ‘owned’ by this template
reqd params : pif-uuid, network-uuid
optional params :
description : Create a new tunnel on a host.
reqd params : uuid
optional params :
description : Destroy a tunnel.
reqd params :
optional params : params, database:, uuid, access-PIF, transport-PIF, status, other-config
description : Lists all the tunnels, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : file-name, host-uuid
optional params :
description : Stream new update to the server.
reqd params : new
optional params : old
description : Change a user’s login password.
reqd params : vm-uuid, device
optional params : vdi-uuid, bootable, type, mode, unpluggable
description : Create a VBD. Appropriate values for the device field are listed in the parameter ‘allowed-VBD-devices’ on the VM. If no VDI is specified, an empty VBD will be created. The type parameter can be ‘Disk’ or ‘CD’, and the mode is ‘RO’ or ‘RW’.
reqd params : uuid
optional params :
description : Destroy a VBD.
reqd params : uuid
optional params :
description : Remove the media from the drive represented by a VBD.
reqd params : uuid, vdi-uuid
optional params :
description : Insert new media into the drive represented by a VBD.
reqd params :
optional params : params, database:, uuid, vm-uuid, vm-name-label, vdi-uuid, vdi-name-label, allowed-operations, current-operations, empty, device, userdevice, bootable, mode, type, unpluggable, currently-attached, attachable, storage-lock, status-code, status-detail, qos_algorithm_type, qos_algorithm_params, qos_supported_algorithms, other-config, io_read_kbs, io_write_kbs, allowed-operations:contains, current-operations:contains, qos_supported_algorithms:contains
description : Lists all the vbds, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be allowed-operations,current-operations,userdevice,bootable,mode,type,unpluggable,qos_algorithm_type,qos_algorithm_params,qos_supported_algorithms,other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : userdevice, bootable, mode, type, unpluggable, qos_algorithm_type, qos_algorithm_params:, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params :
description : Attempt to attach the VBD while the VM is in the running state.
reqd params : uuid
optional params : timeout, force
description : Attempt to detach the VBD while the VM is in the running state. If the optional argument ‘timeout=N’ is given then the command will wait for up to ‘N’ seconds for the unplug to complete. If the optional argument ‘force’ is given then it will be immediately unplugged.
reqd params : uuid
optional params : driver-params-, new-name-label, new-name-description
description : Clone a specified VDI.
reqd params : uuid
optional params : sr-uuid, base-vdi-uuid, into-vdi-uuid
description : Copy either a full VDI or the block differences between two VDIs either into a fresh VDI in a specified SR or into an existing VDI.
reqd params : sr-uuid, name-label, virtual-size
optional params : sm-config:, sharable, tags:, type
description : Create a VDI. Type is ‘system’ ‘user’ ‘suspend’ or ‘crashdump’.
reqd params : uuid
optional params :
description : Destroy a VDI.
reqd params : uuid, filename
optional params : format, base, progress
description : Export a VDI.
reqd params : uuid
optional params :
description : Forget about a VDI.
reqd params : uuid, filename
optional params : format, progress
description : Import a raw VDI.
reqd params : uuid, sr-uuid, type, location
optional params : name-description, sharable, read-only, other-config:, xenstore-data:, sm-config:, name-label
description : Create a VDI object representing an existing disk.
reqd params :
optional params : params, database:, uuid, name-label, name-description, is-a-snapshot, snapshot-of, snapshots, snapshot-time, allowed-operations, current-operations, sr-uuid, sr-name-label, vbd-uuids, crashdump-uuids, virtual-size, physical-utilisation, location, type, sharable, read-only, storage-lock, managed, parent, missing, is-tools-iso, other-config, xenstore-data, sm-config, on-boot, allow-caching, metadata-latest, metadata-of-pool, tags, allowed-operations:contains, current-operations:contains, vbd-uuids:contains, crashdump-uuids:contains, tags:contains
description : Lists all the vdis, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,allowed-operations,current-operations,vbd-uuids,crashdump-uuids,other-config,xenstore-data,sm-config,on-boot,allow-caching,tags).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, on-boot, allow-caching, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid, sr-uuid
optional params :
description : Migrate a VDI to a specified SR, while the VDI is attached to a running guest.
reqd params : uuid, disk-size
optional params : online
description : Resize a VDI.
reqd params : uuid
optional params : driver-params-
description : Snapshot a specified VDI.
reqd params : uuid
optional params : force
description : Attempt to unlock a VDI.
reqd params : uuid
optional params :
description : Refresh the fields of the VDI object in the database.
reqd params : vm-uuid, gpu-group-uuid
optional params : vgpu-type-uuid
description : Create a vGPU.
reqd params : uuid
optional params :
description : Destroy a vGPU.
reqd params :
optional params : params, database:, uuid, vm-uuid, vm-name-label, gpu-group-uuid, gpu-group-name-label, currently-attached, other-config, type-uuid, type-model-name, resident-on
description : Lists all the vgpus, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be other-config).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params : params, database:, uuid, vendor-name, model-name, framebuffer-size, max-heads, max-resolution, supported-on-PGPUs, enabled-on-PGPUs, supported-on-GPU-groups, enabled-on-GPU-groups, VGPU-uuids, experimental
description : Lists all the vgpu-types, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, mode
optional params : address, gateway
description : Configure IPv4 settings on a VIF.
reqd params : uuid, mode
optional params : address, gateway
description : Configure IPv6 settings on a VIF.
reqd params : device, network-uuid, vm-uuid
optional params : mac
description : Create a VIF. Appropriate values for the device are listed in the parameter ‘allowed-VIF-devices’ on the VM. If specified, the MAC parameter is of the form aa:bb:cc:dd:ee:ff. If MAC is not specified the server will choose an appropriate MAC automatically.
reqd params : uuid
optional params :
description : Destroy a VIF.
reqd params :
optional params : params, database:, uuid, vm-uuid, vm-name-label, allowed-operations, current-operations, device, MAC, MAC-autogenerated, MTU, currently-attached, qos_algorithm_type, qos_algorithm_params, qos_supported_algorithms, other-config, network-uuid, network-name-label, io_read_kbs, io_write_kbs, locking-mode, ipv4-allowed, ipv6-allowed, ipv4-configuration-mode, ipv4-addresses, ipv4-gateway, ipv6-configuration-mode, ipv6-addresses, ipv6-gateway, allowed-operations:contains, current-operations:contains, qos_supported_algorithms:contains, ipv4-allowed:contains, ipv6-allowed:contains
description : Lists all the vifs, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be allowed-operations,current-operations,qos_algorithm_type,qos_algorithm_params,qos_supported_algorithms,other-config,locking-mode,ipv4-allowed,ipv6-allowed).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : qos_algorithm_type, locking-mode, ipv4-allowed, ipv6-allowed, qos_algorithm_params:, other-config:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params : uuid
optional params :
description : Attempt to attach the VIF while the VM is in the running state.
reqd params : uuid
optional params : force
description : Attempt to detach the VIF while the VM is in the running state.
reqd params : pif-uuid, vlan, network-uuid
optional params :
description : Create a new VLAN on a host.
reqd params : uuid
optional params :
description : Destroy a VLAN.
reqd params :
optional params : params, database:, uuid, tagged-PIF, untagged-PIF, tag
description : Lists all the vlans, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid
optional params : database:
description : Test whether storage is available to recover this VM.
reqd params : vm-uuid, plugin, fn
optional params : args:
description : Calls the function within the plugin on the given vm with optional arguments (args:key=value). To pass a “value” string with special characters in it (e.g. new line), an alternative syntax args:key:file=local_file can be used in place, where the content of local_file will be retrieved and assigned to “key” as a whole.
reqd params : cd-name, device
optional params : <vm-selectors>
description : Add a CD to the VM(s). The device field should be selected from the parameter ‘allowed-VBD-devices’ of the VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : Eject a CD from the virtual CD drive. This command will only work if there is one and only one CD attached to the VM. When there are two or more CDs, please use the command ‘vbd-eject’ and specify the uuid of the VBD. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : cd-name
optional params : <vm-selectors>
description : Insert a CD into the virtual CD drive. This command will only work if there is one and only one empty CD device attached to the VM. When there are two or more empty CD devices, please use the command ‘vbd-insert’ and specify the uuids of the VBD and of the VDI to insert. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : vbd-params, vdi-params, <vm-selectors>
description : List the CDs currently attached to the VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : cd-name
optional params : <vm-selectors>
description : Remove the selected CDs from the VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-name-label
optional params : new-name-description, <vm-selectors>
description : Checkpoint an existing VM, using storage-level fast disk snapshot operation where available. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-name-label
optional params : new-name-description, <vm-selectors>
description : Clone an existing VM, using storage-level fast disk clone operation where available. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : total
optional params : approximate, <vm-selectors>
description : Compute the maximum amount of guest memory given the VM’s configuration. By default give a precise limit, if approximate is set then allow some extra wiggle-room. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : Computes the virtualization memory overhead of a VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-name-label
optional params : new-name-description, sr-uuid, <vm-selectors>
description : Copy an existing VM, but without using storage-level fast disk clone operation (even if this is available). The disk images of the copied VM are guaranteed to be ‘full images’ – i.e. not part of a CoW chain. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : host-uuid
optional params : <vm-selectors>
description : Copy the BIOS strings of the given host to the VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : List crashdumps associated with the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : data-source
optional params : <vm-selectors>
description : Stop recording the specified data source for a VM, and forget all of the recorded data. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : List the data sources that can be recorded for a VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : data-source
optional params : <vm-selectors>
description : Query the last value read from a VM data source. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : data-source
optional params : <vm-selectors>
description : Record the specified data source for a VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : uuid
optional params :
description : Destroy a VM. This leaves the storage associated with the VM intact. To delete storage too, use vm-uninstall.
reqd params : disk-size, device
optional params : sr-uuid, <vm-selectors>
description : Add a new disk to the selected VM(s). The device field should be selected from the field ‘allowed-VBD-devices’ of the VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : vbd-params, vdi-params, <vm-selectors>
description : List the disks on the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : device
optional params : <vm-selectors>
description : Remove a disk from the selected VM and destroy it. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : filename
optional params : preserve-power-state, compress, <vm-selectors>
description : Export a VM to <filename>. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : filename, preserve, sr-uuid, force, host-username, host-password, type, remote-config, url, vdi:
description : Import a VM. If type=ESXServer is given, it will import from a VMWare server and ‘host-username’, ‘host-password’ and ‘remote-config’ are required. Otherwise, it will import from a file, and ‘filename’ is required. If the option preserve=true is given then as many settings as possible are restored, including VIF MAC addresses. The default is to regenerate VIF MAC addresses. The VDIs will be imported into the Pool’s default SR unless an override is provided. If the force option is given then any disk data checksum failures will be ignored. If the parameter ‘url’ is specified, xapi will attempt to import from that URL.
reqd params : new-name-label
optional params : sr-name-label, sr-uuid, template, copy-bios-strings-from
description : Install a new VM from a template. The template parameter can match either the template name or the uuid.
reqd params :
optional params : <vm-selectors>
description : Indicates whether the BIOS strings of the VM have been customized. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : params, database:, uuid, name-label, name-description, user-version, is-a-template, is-a-snapshot, snapshot-of, snapshots, snapshot-time, snapshot-info, parent, children, is-control-domain, power-state, memory-actual, memory-target, memory-overhead, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-params, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, console-uuids, platform, allowed-operations, current-operations, blocked-operations, allowed-VBD-devices, allowed-VIF-devices, possible-hosts, HVM-boot-policy, HVM-boot-params, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, last-boot-CPU-flags, last-boot-record, resident-on, affinity, other-config, dom-id, recommendations, xenstore-data, ha-always-run, ha-restart-priority, blobs, start-time, install-time, VCPUs-number, VCPUs-utilisation, os-version, PV-drivers-version, PV-drivers-up-to-date, memory, disks, networks, PV-drivers-detected, other, live, guest-metrics-last-updated, can-use-hotplug-vbd, can-use-hotplug-vif, cooperative, tags, appliance, start-delay, shutdown-delay, order, version, generation-id, hardware-platform-version, has-vendor-device, console-uuids:contains, allowed-operations:contains, current-operations:contains, allowed-VBD-devices:contains, allowed-VIF-devices:contains, tags:contains
description : Lists all the vms, filtering on the optional arguments. To filter on map parameters, use the syntax ‘map-param:key=value’
reqd params : min, max
optional params : <vm-selectors>
description : Configure the dynamic memory range of a VM. The dynamic memory range defines soft lower and upper limits for a VM’s memory. It’s possible to change these fields when a VM is running or halted. The dynamic range must fit within the static range. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : static-min, static-max, dynamic-min, dynamic-max
optional params : <vm-selectors>
description : Configure the memory limits of a VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : multiplier
optional params : <vm-selectors>
description : Set the shadow memory multiplier of a VM which may be running. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : min, max
optional params : <vm-selectors>
description : Configure the static memory range of a VM. The static memory range defines hard lower and upper limits for a VM’s memory. It’s possible to change these fields only when a VM is halted. The static range must encompass the dynamic range. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : target
optional params : <vm-selectors>
description : Set the memory target for a halted or running VM. The given value must be within the range defined by the VM’s memory_static_min and memory_static_max values. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : live, host, host-uuid, remote-master, remote-username, remote-password, remote-network, force, copy, vif:, vdi:, <vm-selectors>
description : Migrate the selected VM(s). The parameter ‘–live’ will migrate the VM without shutting it down. The ‘host’ parameter matches can be either the name or the uuid of the host. If you are migrating a VM to a remote pool, you will need to specify the remote-master, remote-username, and remote-password parameters. remote-master is the network address of the master host. To migrate to a particular host within a remote pool, you may additionally specify the host or host-uuid parameters. Also for cross-pool migration, setting ‘copy=true’ will enable the copy mode so that a stopped vm can be copied, instead of migrating, to the destination pool. The vif and vdi mapping parameters take the form ‘vif:<source vif uuid>=<dest network uuid>’ and ‘vdi:<source vdi uuid>=<dest sr uuid>’. Unfortunately, destination uuids cannot be tab-completed. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : uuid, param-name
optional params : param-key
description : Adds to a set or map parameter. If the parameter is a set, use param-key=<key to add>. If the parameter is a map, pass the values to add as ‘key=value’ pairs.
reqd params : uuid, param-name
optional params :
description : Clears the specified parameter (param-name can be name-label,name-description,user-version,is-a-template,memory-static-max,memory-dynamic-max,memory-dynamic-min,memory-static-min,suspend-VDI-uuid,suspend-SR-uuid,VCPUs-params,VCPUs-max,VCPUs-at-startup,actions-after-shutdown,actions-after-reboot,actions-after-crash,console-uuids,platform,allowed-operations,current-operations,blocked-operations,allowed-VBD-devices,allowed-VIF-devices,HVM-boot-policy,HVM-boot-params,HVM-shadow-multiplier,PV-kernel,PV-ramdisk,PV-args,PV-legacy-args,PV-bootloader,PV-bootloader-args,affinity,other-config,xenstore-data,ha-always-run,ha-restart-priority,VCPUs-utilisation,os-version,PV-drivers-version,memory,disks,networks,other,tags,appliance,start-delay,shutdown-delay,order,has-vendor-device).
reqd params : uuid, param-name
optional params : param-key, database:
description : Gets the parameter specified of the object. If the parameter is a map of key=value pairs, use ‘param-key=<key>’ to get the value associated with a particular key.
reqd params : uuid
optional params : database:
description : Lists all the parameters of the object specified by the uuid.
reqd params : uuid, param-name, param-key
optional params :
description : Removes a member or a key,value pair from a set/map respectively.
reqd params : uuid
optional params : name-label, name-description, user-version, is-a-template, memory-static-max, memory-dynamic-max, memory-dynamic-min, memory-static-min, suspend-VDI-uuid, suspend-SR-uuid, VCPUs-max, VCPUs-at-startup, actions-after-shutdown, actions-after-reboot, actions-after-crash, HVM-boot-policy, HVM-shadow-multiplier, PV-kernel, PV-ramdisk, PV-args, PV-legacy-args, PV-bootloader, PV-bootloader-args, affinity, ha-always-run, ha-restart-priority, appliance, start-delay, shutdown-delay, order, has-vendor-device, VCPUs-params:, platform:, blocked-operations:, HVM-boot-params:, other-config:, xenstore-data:
description : Sets the parameter specified. If param-value is not given, the parameter is set to a null value. To set a (key,value) pair in a map parameter, use the syntax ‘map-param:key=value’.
reqd params :
optional params : <vm-selectors>
description : Pause a running VM. Note this operation does not free the associated memory (see ‘vm-suspend’). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : force, <vm-selectors>
description : Reboot the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : uuid
optional params : database:, force
description : Recover a VM from the database contained in the supplied VDI.
reqd params :
optional params : force, <vm-selectors>
description : Force the VM powerstate to halted in the management toolstack database only. This command is used to recover a VM that is marked as ‘running’, but is known to be on a dead slave host that will not recover. This is a potentially dangerous operation: you must ensure that the VM you are forcing to ‘halted’ is definitely not running anywhere. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : force, on, <vm-selectors>
description : Resume the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : Retrieve the workload balancing recommendations for the selected VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : force, <vm-selectors>
description : Shutdown the selected VM(s). The optional argument –force will forcibly shut down the VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-name-label
optional params : new-name-description, <vm-selectors>
description : Snapshot an existing VM, using storage-level fast disk snapshot operation where available. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-name-label
optional params : new-name-description, <vm-selectors>
description : Snapshot an existing VM with quiesce, using storage-level fast disk snapshot operation where available. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : force, on, paused, <vm-selectors>
description : Start the selected VM(s). Where pooling is enabled, the host on which to start can be specified with the ‘on’ parameter that takes a uuid. The optional parameter ‘–force’ will bypass any hardware-compatibility warnings. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : Suspend the selected VM(s). The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : force, <vm-selectors>
description : Uninstall a VM. This operation will destroy those VDIs that are marked RW and connected to this VM only. To simply destroy the VM record, use vm-destroy. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : Unpause a paused VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params : new-vcpus
optional params : <vm-selectors>
description : Dynamically adjust the number of VCPUs available to running VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.
reqd params :
optional params : <vm-selectors>
description : List the VIFs present on selected VM. The simplest way to select the VM on which the operation is to be performed is by supplying the argument ‘vm=<name or uuid>’. VMs can also be specified by filtering the full list of VMs on the values of fields. For example, specifying ‘power-state=halted’ will select all VMs whose power-state field is equal to ‘halted’. Where multiple VMs are matching, the option ‘–multiple’ must be specified to perform the operation. The full list of fields that can be matched can be obtained by the command ‘xe vm-list params=all’. If no parameters to select VMs are given, the operation will be performed on all VMs.