host 
Class: host A physical host
Published in: XenServer 4.0 (rio) A physical host 
Enums host_allowed_operations
Values: provision Indicates this host is able to provision another VM evacuate Indicates this host is evacuating shutdown Indicates this host is in the process of shutting itself down reboot Indicates this host is in the process of rebooting power_on Indicates this host is in the process of being powered on vm_start This host is starting a VM vm_resume This host is resuming a VM vm_migrate This host is the migration target of a VM apply_updates Indicates this host is being updated enable Indicates this host is in the process of enabling 
latest_synced_updates_applied_state
Values: yes The host is up to date with the latest updates synced from remote CDN no The host is outdated with the latest updates synced from remote CDN unknown If the host is up to date with the latest updates synced from remote CDN is unknown 
update_guidances
Values: reboot_host Indicates the updated host should reboot as soon as possible reboot_host_on_livepatch_failure Indicates the updated host should reboot as soon as possible since one or more livepatch(es) failed to be applied. reboot_host_on_kernel_livepatch_failure Indicates the updated host should reboot as soon as possible since one or more kernel livepatch(es) failed to be applied. reboot_host_on_xen_livepatch_failure Indicates the updated host should reboot as soon as possible since one or more xen livepatch(es) failed to be applied. restart_toolstack Indicates the Toolstack running on the updated host should restart as soon as possible restart_device_model Indicates the device model of a running VM should restart as soon as possible restart_vm Indicates the VM should restart as soon as possible 
host_display
Values: enabled This host is outputting its console to a physical display device disable_on_reboot The host will stop outputting its console to a physical display device on next boot disabled This host is not outputting its console to a physical display device enable_on_reboot The host will start outputting its console to a physical display device on next boot 
host_sched_gran
Values: core core scheduling cpu CPU scheduling socket socket scheduling 
host_numa_affinity_policy
Values: any VMs are spread across all available NUMA nodes best_effort VMs are placed on the smallest number of NUMA nodes that they fit using soft-pinning, but the policy doesn't guarantee a balanced placement, falling back to the 'any' policy. default_policy Use the NUMA affinity policy that is the default for the current version 
Fields 
string 
address 
[RW] 
The address by which this host can be contacted from any other host in the pool
Published in: XenServer 4.0 (rio) The address by which this host can be contacted from any other host in the pool 
enum host_allowed_operations set 
allowed_operations 
[RO/runtime] 
list of the operations allowed in this state. This list is advisory only and the server state may have changed by the time this field is read by a client.
Default value: {} Published in: XenServer 4.0 (rio) list of the operations allowed in this state. This list is advisory only and the server state may have changed by the time this field is read by a client. 
int 
API_version_major 
[RO/runtime] 
major version number
Published in: XenServer 4.0 (rio) major version number 
int 
API_version_minor 
[RO/runtime] 
minor version number
Published in: XenServer 4.0 (rio) minor version number 
string 
API_version_vendor 
[RO/runtime] 
identification of vendor
Published in: XenServer 4.0 (rio) identification of vendor 
(string → string) map 
API_version_vendor_implementation 
[RO/runtime] 
details of vendor implementation
Published in: XenServer 4.0 (rio) details of vendor implementation 
(string → string) map 
bios_strings 
[RO/runtime] 
BIOS strings
Default value: {} Published in: XenServer 5.6 (midnight-ride) BIOS strings 
(string → blob ref) map 
blobs 
[RO/runtime] 
Binary blobs associated with this host
Default value: {} Published in: XenServer 5.0 (orlando) Binary blobs associated with this host 
string set 
capabilities 
[RO/constructor] 
Xen capabilities
Published in: XenServer 4.0 (rio) Xen capabilities 
Certificate ref set 
certificates 
[RO/runtime] 
List of certificates installed in the host
Published in: Citrix Hypervisor 8.2 (stockholm) 
(string → string) map 
chipset_info 
[RO/runtime] 
Information about chipset features
Default value: {} Published in: XenServer 6.0 (boston) 
VM ref 
control_domain 
[RO/runtime] 
The control domain (domain 0)
Default value: OpaqueRef:NULL Published in: XenServer 7.1 (ely) The control domain (domain 0) 
(string → string) map 
cpu_configuration 
[RO/runtime] 
The CPU configuration on this host. May contain keys such as "nr_nodes", "sockets_per_node", "cores_per_socket", or "threads_per_core"
Published in: XenServer 4.0 (rio) The CPU configuration on this host. May contain keys such as "nr_nodes", "sockets_per_node", "cores_per_socket", or "threads_per_core" 
(string → string) map 
cpu_info 
[RO/runtime] 
Details about the physical CPUs on this host
Default value: {} Published in: XenServer 5.6 (midnight-ride) Details about the physical CPUs on this host 
SR ref 
crash_dump_sr 
[RW] 
The SR in which VDIs for crash dumps are created
Published in: XenServer 4.0 (rio) The SR in which VDIs for crash dumps are created 
host_crashdump ref set 
crashdumps 
[RO/runtime] 
Set of host crash dumps
Published in: XenServer 4.0 (rio) Set of host crash dumps 
(string → enum host_allowed_operations) map 
current_operations 
[RO/runtime] 
links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task.
Default value: {} Published in: XenServer 4.0 (rio) links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task. 
enum host_display 
display 
[RW] 
indicates whether the host is configured to output its console to a physical display device
Default value: enabled Published in: XenServer 6.5 SP1 (cream) indicates whether the host is configured to output its console to a physical display device 
string 
edition 
[RO/runtime] 
Product edition
Default value: "" Published in: XenServer 5.6 (midnight-ride) Product edition 
string set 
editions 
[RO/runtime] 
List of all available product editions
Default value: {} Published in: Citrix Hypervisor 8.2 (stockholm) 
bool 
enabled 
[RO/runtime] 
True if the host is currently enabled
Published in: XenServer 4.0 (rio) True if the host is currently enabled 
(string → string) map 
external_auth_configuration 
[RO/runtime] 
configuration specific to external authentication service
Default value: {} Published in: XenServer 5.5 (george) configuration specific to external authentication service 
string 
external_auth_service_name 
[RO/runtime] 
name of external authentication service configured; empty if none configured.
Default value: "" Published in: XenServer 5.5 (george) name of external authentication service configured; empty if none configured. 
string 
external_auth_type 
[RO/runtime] 
type of external authentication service configured; empty if none configured.
Default value: "" Published in: XenServer 5.5 (george) type of external authentication service configured; empty if none configured. 
Feature ref set 
features 
[RO/runtime] 
List of features available on this host
Published in: XenServer 7.2 (falcon) 
(string → string) map 
guest_VCPUs_params 
[RW] 
VCPUs params to apply to all resident guests
Default value: {} Published in: XenServer 6.1 (tampa) VCPUs params to apply to all resident guests 
string set 
ha_network_peers 
[RO/runtime] 
The set of hosts visible via the network from this host
Default value: {} Published in: XenServer 5.0 (orlando) The set of hosts visible via the network from this host 
string set 
ha_statefiles 
[RO/runtime] 
The set of statefiles accessible from this host
Default value: {} Published in: XenServer 5.0 (orlando) The set of statefiles accessible from this host 
host_cpu ref set 
host_CPUs 
[RO/runtime] 
The physical CPUs on this host
Published in: XenServer 4.0 (rio) The physical CPUs on this host 
string 
hostname 
[RW] 
The hostname of this host
Published in: XenServer 4.0 (rio) The hostname of this host 
Prototype
bool 
https_only 
[RO/runtime] 
Reflects whether port 80 is open (false) or not (true)
Default value: false Prototyped in: XAPI 22.27.0 (22.27.0) 
string 
iscsi_iqn 
[RO/constructor] 
The initiator IQN for the host
Default value: "" Published in: XenServer 7.5 (kolkata) 
Prototype
datetime 
last_software_update 
[RO/runtime] 
Date and time when the last software update was applied
Default value: 19700101T00:00:00Z Prototyped in: XAPI 22.20.0 (22.20.0) 
Prototype
string 
last_update_hash 
[RO/runtime] 
The SHA256 checksum of updateinfo of the most recently applied update on the host
Default value: "" Prototyped in: XAPI 24.10.0 (24.10.0) 
Prototype
enum latest_synced_updates_applied_state 
latest_synced_updates_applied 
[RO/runtime] 
Default as 'unknown', 'yes' if the host is up to date with updates synced from remote CDN, otherwise 'no'
Default value: unknown Prototyped in: XAPI 23.18.0 (23.18.0) 
(string → string) map 
license_params 
[RO/runtime] 
State of the current license
Published in: XenServer 4.0 (rio) State of the current license 
(string → string) map 
license_server 
[RW] 
Contact information of the license server
Default value: {"address" -> "localhost", "port" -> "27000"} Published in: XenServer 5.6 (midnight-ride) Contact information of the license server 
SR ref 
local_cache_sr 
[RO/constructor] 
The SR that is used as a local cache
Default value: OpaqueRef:NULL Published in: XenServer 5.6 FP1 (cowley) The SR that is used as a local cache 
(string → string) map 
logging 
[RW] 
logging configuration
Published in: XenServer 4.0 (rio) logging configuration 
int 
memory_overhead 
[RO/runtime] 
Virtualization memory overhead (bytes).
Default value: 0 Published in: XenServer 4.0 (rio) Virtualization memory overhead (bytes). 
host_metrics ref 
metrics 
[RO/runtime] 
metrics associated with this host
Published in: XenServer 4.0 (rio) metrics associated with this host 
bool 
multipathing 
[RO/constructor] 
Specifies whether multipathing is enabled
Default value: false Published in: XenServer 7.5 (kolkata) 
string 
name_description 
[RW] 
a notes field containing human-readable description
Default value: "" Published in: XenServer 4.0 (rio) a notes field containing human-readable description 
string 
name_label 
[RW] 
a human-readable name
Default value: "" Published in: XenServer 4.0 (rio) a human-readable name 
Prototype
enum host_numa_affinity_policy 
numa_affinity_policy 
[RO/runtime] 
NUMA-aware VM memory and vCPU placement policy
Default value: default_policy Prototyped in: XAPI 24.0.0 (24.0.0) 
(string → string) map 
other_config 
[RW] 
additional configuration
Published in: XenServer 4.0 (rio) additional configuration 
Deprecated
host_patch ref set 
patches 
[RO/runtime] 
Set of host patches
Published in: XenServer 4.0 (rio) Set of host patches Deprecated in: XenServer 7.1 (ely) 
PBD ref set 
PBDs 
[RO/runtime] 
physical blockdevices
Published in: XenServer 4.0 (rio) physical blockdevices 
PCI ref set 
PCIs 
[RO/runtime] 
List of PCI devices in the host
Published in: XenServer 6.0 (boston) 
enum update_guidances set 
pending_guidances 
[RO/runtime] 
The set of pending mandatory guidances after applying updates, which must be applied, as otherwise there may be e.g. VM failures
Default value: {} Published in: XAPI 1.303.0 (1.303.0) The set of pending mandatory guidances after applying updates, which must be applied, as otherwise there may be e.g. VM failures 
Prototype
enum update_guidances set 
pending_guidances_full 
[RO/runtime] 
The set of pending full guidances after applying updates, which a user should follow to make some updates, e.g. specific hardware drivers or CPU features, fully effective, but the 'average user' doesn't need to
Default value: {} Prototyped in: XAPI 24.10.0 (24.10.0) 
Prototype
enum update_guidances set 
pending_guidances_recommended 
[RO/runtime] 
The set of pending recommended guidances after applying updates, which most users should follow to make the updates effective, but if not followed, will not cause a failure
Default value: {} Prototyped in: XAPI 24.10.0 (24.10.0) 
PGPU ref set 
PGPUs 
[RO/runtime] 
List of physical GPUs in the host
Published in: XenServer 6.0 (boston) 
PIF ref set 
PIFs 
[RO/runtime] 
physical network interfaces
Published in: XenServer 4.0 (rio) physical network interfaces 
(string → string) map 
power_on_config 
[RO/runtime] 
The power on config
Default value: {} Published in: XenServer 5.6 (midnight-ride) The power on config 
string 
power_on_mode 
[RO/runtime] 
The power on mode
Default value: "" Published in: XenServer 5.6 (midnight-ride) The power on mode 
PUSB ref set 
PUSBs 
[RO/runtime] 
List of physical USBs in the host
Published in: XenServer 7.3 (inverness) 
VM ref set 
resident_VMs 
[RO/runtime] 
list of VMs currently resident on host
Published in: XenServer 4.0 (rio) list of VMs currently resident on host 
string 
sched_policy 
[RO/runtime] 
Scheduler policy currently in force on this host
Published in: XenServer 4.0 (rio) Scheduler policy currently in force on this host 
(string → string) map 
software_version 
[RO/constructor] 
version strings
Published in: XenServer 4.0 (rio) version strings 
Deprecated
bool 
ssl_legacy 
[RO/constructor] 
Allow SSLv3 protocol and ciphersuites as used by older server versions. This controls both incoming and outgoing connections. When this is set to a different value, the host immediately restarts its SSL/TLS listening service; typically this takes less than a second but existing connections to it will be broken. API login sessions will remain valid.
Default value: true Published in: XenServer 7.0 (dundee) Deprecated in: Citrix Hypervisor 8.2 (stockholm) Legacy SSL no longer supported 
string set 
supported_bootloaders 
[RO/runtime] 
a list of the bootloaders installed on the machine
Published in: XenServer 4.0 (rio) a list of the bootloaders installed on the machine 
SR ref 
suspend_image_sr 
[RW] 
The SR in which VDIs for suspend images are created
Published in: XenServer 4.0 (rio) The SR in which VDIs for suspend images are created 
bool 
tls_verification_enabled 
[RO/runtime] 
True if this host has TLS verifcation enabled
Default value: false Published in: XAPI 1.313.0 (1.313.0) True if this host has TLS verifcation enabled 
Deprecated
string 
uefi_certificates 
[RO/constructor] 
The UEFI certificates allowing Secure Boot
Default value: "" Published in: Citrix Hypervisor 8.1 (quebec) Deprecated in: XAPI 22.16.0 (22.16.0) Use Pool.uefi_certificates instead 
pool_update ref set 
updates 
[RO/runtime] 
Set of updates
Published in: XenServer 7.1 (ely) Set of updates 
pool_update ref set 
updates_requiring_reboot 
[RO/runtime] 
List of updates which require reboot
Published in: XenServer 7.1 (ely) 
string 
uuid 
[RO/runtime] 
Unique identifier/object reference
Published in: XenServer 4.0 (rio) Unique identifier/object reference 
int set 
virtual_hardware_platform_versions 
[RO/runtime] 
Messages
Hide implicit  
void 
add_tags 
(session ref , host ref , string ) 
void 
add_to_guest_VCPUs_params 
(session ref , host ref , string , string ) 
Add the given key-value pair to the guest_VCPUs_params field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to add string value Value to add Minimum role: pool-operator Published in: XenServer 6.1 (tampa) VCPUs params to apply to all resident guests 
void 
add_to_license_server 
(session ref , host ref , string , string ) 
Add the given key-value pair to the license_server field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to add string value Value to add Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Contact information of the license server 
void 
add_to_logging 
(session ref , host ref , string , string ) 
Add the given key-value pair to the logging field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to add string value Value to add Minimum role: pool-operator Published in: XenServer 4.0 (rio) logging configuration 
void 
add_to_other_config 
(session ref , host ref , string , string ) 
Add the given key-value pair to the other_config field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to add string value Value to add Minimum role: pool-operator Published in: XenServer 4.0 (rio) additional configuration 
void 
apply_edition 
(session ref , host ref , string , bool ) 
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.
Parameters: session ref session_id Reference to a valid session host ref host The host string edition The requested edition bool force Update the license params even if the apply call fails Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) 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. 
Removed
void 
apply_recommended_guidances 
(session ref , host ref ) 
apply all recommended guidances both on the host and on all HVM VMs on the host after updates are applied on the host
Parameters: session ref session_id Reference to a valid session host ref self The host whose recommended guidances will be applied Minimum role: pool-operator Prototyped in: XAPI 23.18.0 (23.18.0) Removed in: XAPI 23.25.0 (23.25.0) 
string set set 
apply_updates 
(session ref , host ref , string ) 
apply updates from current enabled repository on a host
Parameters: session ref session_id Reference to a valid session host ref self The host where updates will be applied string hash The hash of updateinfo to be applied which is returned by previous pool.sync_udpates Minimum role: client-cert Result: The list of results after applying updates, including livepatch apply failures and recommended guidances Published in: XAPI 1.301.0 (1.301.0) apply updates from current enabled repository on a host 
void 
assert_can_evacuate 
(session ref , host ref ) 
Check this host can be evacuated.
Parameters: session ref session_id Reference to a valid session host ref host The host to evacuate Minimum role: pool-operator Published in: XenServer 4.1 (miami) Check this host can be evacuated. 
void 
backup_rrds 
(session ref , host ref , float ) 
This causes the RRDs to be backed up to the master
Parameters: session ref session_id Reference to a valid session host ref host Schedule a backup of the RRDs of this host float delay Delay in seconds from when the call is received to perform the backup Minimum role: pool-admin Published in: XenServer 5.0 (orlando) This causes the RRDs to be backed up to the master 
void 
bugreport_upload 
(session ref , host ref , string , (string → string) map ) 
Run xen-bugtool --yestoall and upload the output to support
Parameters: session ref session_id Reference to a valid session host ref host The host on which to run xen-bugtool string url The URL to upload to (string → string) map options Extra configuration operations Minimum role: pool-operator Published in: XenServer 4.0 (rio) Run xen-bugtool --yestoall and upload the output to support 
string 
call_extension 
(session ref , host ref , string ) 
Call an API extension on this host
Parameters: session ref session_id Reference to a valid session host ref host The host string call Rpc call for the extension Minimum role: pool-admin Result: Result from the extension Published in: XenServer 7.1 (ely) Call an API extension on this host 
string 
call_plugin 
(session ref , host ref , string , string , (string → string) map ) 
Call an API plugin on this host
Parameters: session ref session_id Reference to a valid session host ref host The host string plugin The name of the plugin string fn The name of the function within the plugin (string → string) map args Arguments for the function Minimum role: pool-admin Result: Result from the plugin Published in: XenServer 5.0 (orlando) Call an API plugin on this host 
int 
compute_free_memory 
(session ref , host ref ) 
Computes the amount of free memory on the host.
Parameters: session ref session_id Reference to a valid session host ref host The host to send the request to Minimum role: read-only Result: the amount of free memory on the host. Published in: XenServer 5.0 (orlando) Computes the amount of free memory on the host. 
int 
compute_memory_overhead 
(session ref , host ref ) 
Computes the virtualization memory overhead of a host.
Parameters: session ref session_id Reference to a valid session host ref host The host for which to compute the memory overhead Minimum role: read-only Result: the virtualization memory overhead of the host. Published in: XenServer 5.6 (midnight-ride) Computes the virtualization memory overhead of a host. 
blob ref 
create_new_blob 
(session ref , host ref , string , string , bool ) 
Create a placeholder for a named binary blob of data that is associated with this host
Parameters: session ref session_id Reference to a valid session host ref host The host string name The name associated with the blob string mime_type The mime type for the data. Empty string translates to application/octet-stream bool public True if the blob should be publicly available Minimum role: pool-operator Result: The reference of the blob, needed for populating its data Published in: XenServer 5.0 (orlando) Create a placeholder for a named binary blob of data that is associated with this host 
void 
declare_dead 
(session ref , host ref ) 
Declare that a host is dead. This is a dangerous operation, and should only be called if the administrator is absolutely sure the host is definitely dead
Parameters: session ref session_id Reference to a valid session host ref host The Host to declare is dead Minimum role: pool-operator Published in: XenServer 6.2 (clearwater) Declare that a host is dead. This is a dangerous operation, and should only be called if the administrator is absolutely sure the host is definitely dead 
void 
destroy 
(session ref , host ref ) 
Destroy specified host record in database
Parameters: session ref session_id Reference to a valid session host ref self The host record to remove Minimum role: pool-operator Published in: XenServer 4.0 (rio) Destroy specified host record in database 
void 
disable 
(session ref , host ref ) 
Puts the host into a state in which no new VMs can be started. Currently active VMs on the host continue to execute.
Parameters: session ref session_id Reference to a valid session host ref host The Host to disable Minimum role: client-cert Published in: XenServer 4.0 (rio) Puts the host into a state in which no new VMs can be started. Currently active VMs on the host continue to execute. 
enum host_display 
disable_display 
(session ref , host ref ) 
Disable console output to the physical display device next time this host boots
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-operator Result: This host's physical display usage Published in: XenServer 6.5 SP1 (cream) 
void 
disable_external_auth 
(session ref , host ref , (string → string) map ) 
This call disables external authentication on the local host
Parameters: session ref session_id Reference to a valid session host ref host The host whose external authentication should be disabled (string → string) map config Optional parameters as a list of key-values containing the configuration data Minimum role: pool-admin Published in: XenServer 5.5 (george) This call disables external authentication on the local host 
void 
disable_local_storage_caching 
(session ref , host ref ) 
Disable the use of a local SR for caching purposes
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-operator Published in: XenServer 5.6 FP1 (cowley) Disable the use of a local SR for caching purposes 
string 
dmesg 
(session ref , host ref ) 
Get the host xen dmesg.
Parameters: session ref session_id Reference to a valid session host ref host The Host to query Minimum role: pool-operator Result: dmesg string Published in: XenServer 4.0 (rio) Get the host xen dmesg. 
string 
dmesg_clear 
(session ref , host ref ) 
Get the host xen dmesg, and clear the buffer.
Parameters: session ref session_id Reference to a valid session host ref host The Host to query Minimum role: pool-operator Result: dmesg string Published in: XenServer 4.0 (rio) Get the host xen dmesg, and clear the buffer. 
Prototype
void 
emergency_clear_mandatory_guidance 
(session ref ) 
Clear the pending mandatory guidance on this host
Parameters: session ref session_id Reference to a valid session Minimum role: Prototyped in: XAPI 24.10.0 (24.10.0) 
void 
emergency_disable_tls_verification 
(session ref ) 
Disable TLS verification for this host only
Parameters: session ref session_id Reference to a valid session Minimum role: Published in: XAPI 1.290.0 (1.290.0) 
void 
emergency_ha_disable 
(session ref , bool ) 
This call disables HA on the local host. This should only be used with extreme care.
Parameters: session ref session_id Reference to a valid session bool soft Disable HA temporarily, revert upon host reboot or further changes, idempotent Minimum role: pool-operator Published in: XenServer 5.0 (orlando) This call disables HA on the local host. This should only be used with extreme care. 
void 
emergency_reenable_tls_verification 
(session ref ) 
Reenable TLS verification for this host only
Parameters: session ref session_id Reference to a valid session Minimum role: Published in: XAPI 1.298.0 (1.298.0) 
void 
emergency_reset_server_certificate 
(session ref ) 
Delete the current TLS server certificate and replace by a new, self-signed one. This should only be used with extreme care.
Parameters: session ref session_id Reference to a valid session Minimum role: Published in: Citrix Hypervisor 8.2 (stockholm) 
void 
enable 
(session ref , host ref ) 
Puts the host into a state in which new VMs can be started.
Parameters: session ref session_id Reference to a valid session host ref host The Host to enable Minimum role: client-cert Published in: XenServer 4.0 (rio) Puts the host into a state in which new VMs can be started. 
enum host_display 
enable_display 
(session ref , host ref ) 
Enable console output to the physical display device next time this host boots
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-operator Result: This host's physical display usage Published in: XenServer 6.5 SP1 (cream) 
void 
enable_external_auth 
(session ref , host ref , (string → string) map , string , string ) 
This call enables external authentication on a host
Parameters: session ref session_id Reference to a valid session host ref host The host whose external authentication should be enabled (string → string) map config A list of key-values containing the configuration data string service_name The name of the service string auth_type The type of authentication (e.g. AD for Active Directory) Minimum role: pool-admin Published in: XenServer 5.5 (george) This call enables external authentication on a host 
void 
enable_local_storage_caching 
(session ref , host ref , SR ref ) 
Enable the use of a local SR for caching purposes
Parameters: session ref session_id Reference to a valid session host ref host The host SR ref sr The SR to use as a local cache Minimum role: pool-operator Published in: XenServer 5.6 FP1 (cowley) Enable the use of a local SR for caching purposes 
void 
evacuate 
(session ref , host ref , network ref , int ) 
Migrate all VMs off of this host, where possible.
Parameters: session ref session_id Reference to a valid session host ref host The host to evacuate network ref network Optional preferred network for migration int evacuate_batch_size The maximum number of VMs to be migrated per batch 0 will use the value `evacuation-batch-size` defined in xapi.conf Minimum role: client-cert Published in: XenServer 4.1 (miami) Extended in: XAPI 1.297.0 (1.297.0) Enable migration network selection. Extended in: XAPI 23.27.0 (23.27.0) Choose batch size of VM evacuation. 
void 
forget_data_source_archives 
(session ref , host ref , string ) 
Forget the recorded statistics related to the specified data source
Parameters: session ref session_id Reference to a valid session host ref host The host string data_source The data source whose archives are to be forgotten Minimum role: pool-operator Published in: XenServer 5.0 (orlando) Forget the recorded statistics related to the specified data source 
string 
get_address 
(session ref , host ref ) 
Get the address field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The address by which this host can be contacted from any other host in the pool 
host ref set 
get_all 
(session ref ) 
Return a list of all the hosts known to the system.
Parameters: session ref session_id Reference to a valid session Minimum role: read-only Result: references to all objects Published in: XenServer 4.0 (rio) A physical host 
(host ref → host record) map 
get_all_records 
(session ref ) 
Return a map of host references to host records for all hosts known to the system.
Parameters: session ref session_id Reference to a valid session Minimum role: read-only Result: records of all objects Published in: XenServer 4.0 (rio) A physical host 
enum host_allowed_operations set 
get_allowed_operations 
(session ref , host ref ) 
Get the allowed_operations field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) list of the operations allowed in this state. This list is advisory only and the server state may have changed by the time this field is read by a client. 
int 
get_API_version_major 
(session ref , host ref ) 
Get the API_version/major field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) major version number 
int 
get_API_version_minor 
(session ref , host ref ) 
Get the API_version/minor field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) minor version number 
string 
get_API_version_vendor 
(session ref , host ref ) 
Get the API_version/vendor field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) identification of vendor 
(string → string) map 
get_API_version_vendor_implementation 
(session ref , host ref ) 
Get the API_version/vendor_implementation field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) details of vendor implementation 
(string → string) map 
get_bios_strings 
(session ref , host ref ) 
Get the bios_strings field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) BIOS strings 
(string → blob ref) map 
get_blobs 
(session ref , host ref ) 
Get the blobs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.0 (orlando) Binary blobs associated with this host 
host ref set 
get_by_name_label 
(session ref , string ) 
Get all the host instances with the given label.
Parameters: session ref session_id Reference to a valid session string label label of object to return Minimum role: read-only Result: references to objects with matching names Published in: XenServer 4.0 (rio) A physical host 
host ref 
get_by_uuid 
(session ref , string ) 
Get a reference to the host instance with the specified UUID.
Parameters: session ref session_id Reference to a valid session string uuid UUID of object to return Minimum role: read-only Result: reference to the object Published in: XenServer 4.0 (rio) A physical host 
string set 
get_capabilities 
(session ref , host ref ) 
Get the capabilities field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Xen capabilities 
Certificate ref set 
get_certificates 
(session ref , host ref ) 
Get the certificates field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: Citrix Hypervisor 8.2 (stockholm) 
(string → string) map 
get_chipset_info 
(session ref , host ref ) 
Get the chipset_info field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 6.0 (boston) 
VM ref 
get_control_domain 
(session ref , host ref ) 
Get the control_domain field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.1 (ely) The control domain (domain 0) 
(string → string) map 
get_cpu_configuration 
(session ref , host ref ) 
Get the cpu_configuration field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The CPU configuration on this host. May contain keys such as "nr_nodes", "sockets_per_node", "cores_per_socket", or "threads_per_core" 
(string → string) map 
get_cpu_info 
(session ref , host ref ) 
Get the cpu_info field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) Details about the physical CPUs on this host 
SR ref 
get_crash_dump_sr 
(session ref , host ref ) 
Get the crash_dump_sr field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The SR in which VDIs for crash dumps are created 
host_crashdump ref set 
get_crashdumps 
(session ref , host ref ) 
Get the crashdumps field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Set of host crash dumps 
(string → enum host_allowed_operations) map 
get_current_operations 
(session ref , host ref ) 
Get the current_operations field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task. 
data_source record set 
get_data_sources 
(session ref , host ref ) 
Parameters: session ref session_id Reference to a valid session host ref host The host to interrogate Minimum role: read-only Result: A set of data sources Published in: XenServer 5.0 (orlando) 
enum host_display 
get_display 
(session ref , host ref ) 
Get the display field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 6.5 SP1 (cream) indicates whether the host is configured to output its console to a physical display device 
string 
get_edition 
(session ref , host ref ) 
Get the edition field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) Product edition 
string set 
get_editions 
(session ref , host ref ) 
Get the editions field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: Citrix Hypervisor 8.2 (stockholm) 
bool 
get_enabled 
(session ref , host ref ) 
Get the enabled field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) True if the host is currently enabled 
(string → string) map 
get_external_auth_configuration 
(session ref , host ref ) 
Get the external_auth_configuration field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.5 (george) configuration specific to external authentication service 
string 
get_external_auth_service_name 
(session ref , host ref ) 
Get the external_auth_service_name field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.5 (george) name of external authentication service configured; empty if none configured. 
string 
get_external_auth_type 
(session ref , host ref ) 
Get the external_auth_type field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.5 (george) type of external authentication service configured; empty if none configured. 
Feature ref set 
get_features 
(session ref , host ref ) 
Get the features field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.2 (falcon) 
(string → string) map 
get_guest_VCPUs_params 
(session ref , host ref ) 
Get the guest_VCPUs_params field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 6.1 (tampa) VCPUs params to apply to all resident guests 
string set 
get_ha_network_peers 
(session ref , host ref ) 
Get the ha_network_peers field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.0 (orlando) The set of hosts visible via the network from this host 
string set 
get_ha_statefiles 
(session ref , host ref ) 
Get the ha_statefiles field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.0 (orlando) The set of statefiles accessible from this host 
host_cpu ref set 
get_host_CPUs 
(session ref , host ref ) 
Get the host_CPUs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The physical CPUs on this host 
string 
get_hostname 
(session ref , host ref ) 
Get the hostname field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The hostname of this host 
Prototype
bool 
get_https_only 
(session ref , host ref ) 
Get the https_only field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 22.27.0 (22.27.0) 
string 
get_iscsi_iqn 
(session ref , host ref ) 
Get the iscsi_iqn field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.5 (kolkata) 
Prototype
datetime 
get_last_software_update 
(session ref , host ref ) 
Get the last_software_update field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 22.20.0 (22.20.0) 
Prototype
string 
get_last_update_hash 
(session ref , host ref ) 
Get the last_update_hash field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 24.10.0 (24.10.0) 
Prototype
enum latest_synced_updates_applied_state 
get_latest_synced_updates_applied 
(session ref , host ref ) 
Get the latest_synced_updates_applied field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 23.18.0 (23.18.0) 
(string → string) map 
get_license_params 
(session ref , host ref ) 
Get the license_params field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) State of the current license 
(string → string) map 
get_license_server 
(session ref , host ref ) 
Get the license_server field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) Contact information of the license server 
SR ref 
get_local_cache_sr 
(session ref , host ref ) 
Get the local_cache_sr field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 FP1 (cowley) The SR that is used as a local cache 
string 
get_log 
(session ref , host ref ) 
Get the host's log file
Parameters: session ref session_id Reference to a valid session host ref host The Host to query Minimum role: read-only Result: The contents of the host's primary log file Published in: XenServer 4.0 (rio) Get the host's log file 
(string → string) map 
get_logging 
(session ref , host ref ) 
Get the logging field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) logging configuration 
PIF ref 
get_management_interface 
(session ref , host ref ) 
Returns the management interface for the specified host
Parameters: session ref session_id Reference to a valid session host ref host Which host's management interface is required Minimum role: pool-operator Result: The management interface for the host Published in: XenServer 6.1 (tampa) 
int 
get_memory_overhead 
(session ref , host ref ) 
Get the memory/overhead field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Virtualization memory overhead (bytes). 
host_metrics ref 
get_metrics 
(session ref , host ref ) 
Get the metrics field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) metrics associated with this host 
bool 
get_multipathing 
(session ref , host ref ) 
Get the multipathing field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.5 (kolkata) 
string 
get_name_description 
(session ref , host ref ) 
Get the name/description field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) a notes field containing human-readable description 
string 
get_name_label 
(session ref , host ref ) 
Get the name/label field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) a human-readable name 
Prototype
enum host_numa_affinity_policy 
get_numa_affinity_policy 
(session ref , host ref ) 
Get the numa_affinity_policy field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 24.0.0 (24.0.0) 
(string → string) map 
get_other_config 
(session ref , host ref ) 
Get the other_config field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) additional configuration 
Deprecated
host_patch ref set 
get_patches 
(session ref , host ref ) 
Get the patches field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Set of host patches Deprecated in: XenServer 7.1 (ely) 
PBD ref set 
get_PBDs 
(session ref , host ref ) 
Get the PBDs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) physical blockdevices 
PCI ref set 
get_PCIs 
(session ref , host ref ) 
Get the PCIs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 6.0 (boston) 
enum update_guidances set 
get_pending_guidances 
(session ref , host ref ) 
Get the pending_guidances field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XAPI 1.303.0 (1.303.0) The set of pending mandatory guidances after applying updates, which must be applied, as otherwise there may be e.g. VM failures 
Prototype
enum update_guidances set 
get_pending_guidances_full 
(session ref , host ref ) 
Get the pending_guidances_full field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 24.10.0 (24.10.0) 
Prototype
enum update_guidances set 
get_pending_guidances_recommended 
(session ref , host ref ) 
Get the pending_guidances_recommended field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Prototyped in: XAPI 24.10.0 (24.10.0) 
PGPU ref set 
get_PGPUs 
(session ref , host ref ) 
Get the PGPUs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 6.0 (boston) 
PIF ref set 
get_PIFs 
(session ref , host ref ) 
Get the PIFs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) physical network interfaces 
(string → string) map 
get_power_on_config 
(session ref , host ref ) 
Get the power_on_config field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) The power on config 
string 
get_power_on_mode 
(session ref , host ref ) 
Get the power_on_mode field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.6 (midnight-ride) The power on mode 
PUSB ref set 
get_PUSBs 
(session ref , host ref ) 
Get the PUSBs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.3 (inverness) 
host record 
get_record 
(session ref , host ref ) 
Get a record containing the current state of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: all fields from the object Published in: XenServer 4.0 (rio) A physical host 
VM ref set 
get_resident_VMs 
(session ref , host ref ) 
Get the resident_VMs field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) list of VMs currently resident on host 
enum host_sched_gran 
get_sched_gran 
(session ref , host ref ) 
Gets xen's sched-gran on a host
Parameters: session ref session_id Reference to a valid session host ref self The host Minimum role: Result: The host's sched-gran Published in: XAPI 1.271.0 (1.271.0) 
string 
get_sched_policy 
(session ref , host ref ) 
Get the sched_policy field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Scheduler policy currently in force on this host 
string 
get_server_certificate 
(session ref , host ref ) 
Get the installed server public TLS certificate.
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: read-only Result: The installed server public TLS certificate, in PEM form. Published in: XenServer 5.5 (george) Changed in: XenServer 7.3 (inverness) Now available to all RBAC roles. 
datetime 
get_server_localtime 
(session ref , host ref ) 
This call queries the host's clock for the current time in the host's local timezone
Parameters: session ref session_id Reference to a valid session host ref host The host whose clock should be queried Minimum role: read-only Result: The current local time Published in: XenServer 5.6 FP1 (cowley) This call queries the host's clock for the current time in the host's local timezone 
datetime 
get_servertime 
(session ref , host ref ) 
This call queries the host's clock for the current time
Parameters: session ref session_id Reference to a valid session host ref host The host whose clock should be queried Minimum role: read-only Result: The current time Published in: XenServer 5.0 (orlando) This call queries the host's clock for the current time 
(string → string) map 
get_software_version 
(session ref , host ref ) 
Get the software_version field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) version strings 
Deprecated
bool 
get_ssl_legacy 
(session ref , host ref ) 
Get the ssl_legacy field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.0 (dundee) Deprecated in: Citrix Hypervisor 8.2 (stockholm) Legacy SSL no longer supported 
string set 
get_supported_bootloaders 
(session ref , host ref ) 
Get the supported_bootloaders field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) a list of the bootloaders installed on the machine 
SR ref 
get_suspend_image_sr 
(session ref , host ref ) 
Get the suspend_image_sr field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) The SR in which VDIs for suspend images are created 
string 
get_system_status_capabilities 
(session ref , host ref ) 
Parameters: session ref session_id Reference to a valid session host ref host The host to interrogate Minimum role: read-only Result: An XML fragment containing the system status capabilities. Published in: XenServer 4.1 (miami) 
string set 
get_tags 
(session ref , host ref ) 
bool 
get_tls_verification_enabled 
(session ref , host ref ) 
Get the tls_verification_enabled field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XAPI 1.313.0 (1.313.0) True if this host has TLS verifcation enabled 
Deprecated
string 
get_uefi_certificates 
(session ref , host ref ) 
Get the uefi_certificates field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: Citrix Hypervisor 8.1 (quebec) Deprecated in: XAPI 22.16.0 (22.16.0) Use Pool.uefi_certificates instead 
Deprecated
VM ref set 
get_uncooperative_resident_VMs 
(session ref , host ref ) 
Return a set of VMs which are not co-operating with the host's memory control system
Parameters: session ref session_id Reference to a valid session host ref self The host to query Minimum role: read-only Result: VMs which are not co-operating Published in: XenServer 5.6 (midnight-ride) Return a set of VMs which are not co-operating with the host's memory control system Deprecated in: XenServer 6.1 (tampa) 
pool_update ref set 
get_updates 
(session ref , host ref ) 
Get the updates field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.1 (ely) Set of updates 
pool_update ref set 
get_updates_requiring_reboot 
(session ref , host ref ) 
Get the updates_requiring_reboot field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 7.1 (ely) 
string 
get_uuid 
(session ref , host ref ) 
Get the uuid field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Unique identifier/object reference 
int set 
get_virtual_hardware_platform_versions 
(session ref , host ref ) 
(VM ref → string set) map 
get_vms_which_prevent_evacuation 
(session ref , host ref ) 
Return a set of VMs which prevent the host being evacuated, with per-VM error codes
Parameters: session ref session_id Reference to a valid session host ref self The host to query Minimum role: read-only Result: VMs which block evacuation together with reasons Published in: XenServer 5.0 (orlando) Return a set of VMs which prevent the host being evacuated, with per-VM error codes 
bool 
has_extension 
(session ref , host ref , string ) 
Return true if the extension is available on the host
Parameters: session ref session_id Reference to a valid session host ref host The host string name The name of the API call Minimum role: pool-admin Result: True if the extension exists, false otherwise Published in: XenServer 7.1 (ely) Return true if the extension is available on the host 
void 
install_server_certificate 
(session ref , host ref , string , string , string ) 
Install the TLS server certificate.
Parameters: session ref session_id Reference to a valid session host ref host The host string certificate The server certificate, in PEM form string private_key The unencrypted private key used to sign the certificate, in PKCS#8 form string certificate_chain The certificate chain, in PEM form Minimum role: pool-admin Published in: Citrix Hypervisor 8.2 (stockholm) 
void 
license_add 
(session ref , host ref , string ) 
Apply a new license to a host
Parameters: session ref session_id Reference to a valid session host ref host The host to upload the license to string contents The contents of the license file, base64 encoded Minimum role: pool-operator Errors: LICENSE_PROCESSING_ERROR There was an error processing your license. Please contact your support representative. Published in: XenServer 6.5 SP1 Hotfix 31 (indigo) Functionality for parsing license files re-added 
Removed
void 
license_apply 
(session ref , host ref , string ) 
Apply a new license to a host
Parameters: session ref session_id Reference to a valid session host ref host The host to upload the license to string contents The contents of the license file, base64 encoded Minimum role: pool-operator Errors: LICENSE_PROCESSING_ERROR There was an error processing your license. Please contact your support representative. Published in: XenServer 4.0 (rio) Apply a new license to a host Deprecated in: XenServer 6.2 (clearwater) Dummy transition Removed in: XenServer 6.2 (clearwater) Free licenses no longer handled by xapi 
void 
license_remove 
(session ref , host ref ) 
Remove any license file from the specified host, and switch that host to the unlicensed edition
Parameters: session ref session_id Reference to a valid session host ref host The host from which any license will be removed Minimum role: pool-operator Published in: XenServer 6.5 SP1 Hotfix 31 (indigo) 
string set 
list_methods 
(session ref ) 
List all supported methods
Parameters: session ref session_id Reference to a valid session Minimum role: read-only Result: The name of every supported method. Published in: XenServer 4.0 (rio) List all supported methods 
void 
local_management_reconfigure 
(session ref , string ) 
void 
management_disable 
(session ref ) 
Disable the management network interface
Parameters: session ref session_id Reference to a valid session Minimum role: pool-operator Published in: XenServer 4.1 (miami) Disable the management network interface 
void 
management_reconfigure 
(session ref , PIF ref ) 
(string → string) map 
migrate_receive 
(session ref , host ref , network ref , (string → string) map ) 
Prepare to receive a VM, returning a token which can be passed to VM.migrate.
Parameters: session ref session_id Reference to a valid session host ref host The target host network ref network The network through which migration traffic should be received. (string → string) map options Extra configuration operations Minimum role: vm-power-admin Result: A value which should be passed to VM.migrate Published in: XenServer 6.1 (tampa) Prepare to receive a VM, returning a token which can be passed to VM.migrate. 
void 
power_on 
(session ref , host ref ) 
Attempt to power-on the host (if the capability exists).
Parameters: session ref session_id Reference to a valid session host ref host The Host to power on Minimum role: pool-operator Published in: XenServer 5.0 (orlando) Attempt to power-on the host (if the capability exists). 
float 
query_data_source 
(session ref , host ref , string ) 
Query the latest value of the specified data source
Parameters: session ref session_id Reference to a valid session host ref host The host string data_source The data source to query Minimum role: read-only Result: The latest value, averaged over the last 5 seconds Published in: XenServer 5.0 (orlando) Query the latest value of the specified data source 
void 
reboot 
(session ref , host ref ) 
Reboot the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.)
Parameters: session ref session_id Reference to a valid session host ref host The Host to reboot Minimum role: pool-operator Published in: XenServer 4.0 (rio) Reboot the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.) 
void 
record_data_source 
(session ref , host ref , string ) 
Start recording the specified data source
Parameters: session ref session_id Reference to a valid session host ref host The host string data_source The data source to record Minimum role: pool-operator Published in: XenServer 5.0 (orlando) Start recording the specified data source 
Deprecated
void 
refresh_pack_info 
(session ref , host ref ) 
Refresh the list of installed Supplemental Packs.
Parameters: session ref session_id Reference to a valid session host ref host The Host to modify Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Deprecated in: XenServer 7.1 (ely) Use Pool_update.resync_host instead 
void 
refresh_server_certificate 
(session ref , host ref ) 
Replace the internal self-signed host certficate with a new one.
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-admin Published in: XAPI 1.307.0 (1.307.0) 
void 
remove_from_guest_VCPUs_params 
(session ref , host ref , string ) 
Remove the given key and its corresponding value from the guest_VCPUs_params field of the given host. If the key is not in that Map, then do nothing.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to remove Minimum role: pool-operator Published in: XenServer 6.1 (tampa) VCPUs params to apply to all resident guests 
void 
remove_from_license_server 
(session ref , host ref , string ) 
Remove the given key and its corresponding value from the license_server field of the given host. If the key is not in that Map, then do nothing.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to remove Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Contact information of the license server 
void 
remove_from_logging 
(session ref , host ref , string ) 
Remove the given key and its corresponding value from the logging field of the given host. If the key is not in that Map, then do nothing.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to remove Minimum role: pool-operator Published in: XenServer 4.0 (rio) logging configuration 
void 
remove_from_other_config 
(session ref , host ref , string ) 
Remove the given key and its corresponding value from the other_config field of the given host. If the key is not in that Map, then do nothing.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string key Key to remove Minimum role: pool-operator Published in: XenServer 4.0 (rio) additional configuration 
void 
remove_tags 
(session ref , host ref , string ) 
Removed
void 
reset_cpu_features 
(session ref , host ref ) 
Remove the feature mask, such that after a reboot all features of the CPU are enabled.
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Deprecated in: XenServer 7.0 (dundee) Dummy transition Removed in: XenServer 7.0 (dundee) Manual CPU feature setting was removed 
void 
reset_server_certificate 
(session ref , host ref ) 
Delete the current TLS server certificate and replace by a new, self-signed one. This should only be used with extreme care.
Parameters: session ref session_id Reference to a valid session host ref host The host Minimum role: pool-admin Published in: XAPI 1.290.0 (1.290.0) 
void 
restart_agent 
(session ref , host ref ) 
Restarts the agent after a 10 second pause. WARNING: this is a dangerous operation. Any operations in progress will be aborted, and unrecoverable data loss may occur. The caller is responsible for ensuring that there are no operations in progress when this method is called.
Parameters: session ref session_id Reference to a valid session host ref host The Host on which you want to restart the agent Minimum role: pool-operator Published in: XenServer 4.0 (rio) Restarts the agent after a 10 second pause. WARNING: this is a dangerous operation. Any operations in progress will be aborted, and unrecoverable data loss may occur. The caller is responsible for ensuring that there are no operations in progress when this method is called. 
(VM ref → string set) map 
retrieve_wlb_evacuate_recommendations 
(session ref , host ref ) 
Retrieves recommended host migrations to perform when evacuating the host from the wlb server. If a VM cannot be migrated from the host the reason is listed instead of a recommendation.
Parameters: session ref session_id Reference to a valid session host ref self The host to query Minimum role: read-only Result: VMs and the reasons why they would block evacuation, or their target host recommended by the wlb server Published in: XenServer 5.5 (george) Retrieves recommended host migrations to perform when evacuating the host from the wlb server. If a VM cannot be migrated from the host the reason is listed instead of a recommendation. 
void 
send_debug_keys 
(session ref , host ref , string ) 
Inject the given string as debugging keys into Xen
Parameters: session ref session_id Reference to a valid session host ref host The host string keys The keys to send Minimum role: pool-admin Published in: XenServer 4.0 (rio) Inject the given string as debugging keys into Xen 
void 
set_address 
(session ref , host ref , string ) 
Set the address field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) The address by which this host can be contacted from any other host in the pool 
Removed
void 
set_cpu_features 
(session ref , host ref , string ) 
Set the CPU features to be used after a reboot, if the given features string is valid.
Parameters: session ref session_id Reference to a valid session host ref host The host string features The features string (32 hexadecimal digits) Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Deprecated in: XenServer 7.0 (dundee) Dummy transition Removed in: XenServer 7.0 (dundee) Manual CPU feature setting was removed 
void 
set_crash_dump_sr 
(session ref , host ref , SR ref ) 
Set the crash_dump_sr field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object SR ref value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) The SR in which VDIs for crash dumps are created 
void 
set_display 
(session ref , host ref , enum host_display ) 
Set the display field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object enum host_display value New value to set Minimum role: pool-operator Published in: XenServer 6.5 SP1 (cream) indicates whether the host is configured to output its console to a physical display device 
void 
set_guest_VCPUs_params 
(session ref , host ref , (string → string) map ) 
Set the guest_VCPUs_params field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object (string → string) map value New value to set Minimum role: pool-operator Published in: XenServer 6.1 (tampa) VCPUs params to apply to all resident guests 
void 
set_hostname 
(session ref , host ref , string ) 
Set the hostname field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) The hostname of this host 
void 
set_hostname_live 
(session ref , host ref , string ) 
Sets the host name to the specified string. Both the API and lower-level system hostname are changed immediately.
Parameters: session ref session_id Reference to a valid session host ref host The host whose host name to set string hostname The new host name Minimum role: pool-operator Errors: HOST_NAME_INVALID The server name is invalid. Published in: XenServer 4.1 (miami) Sets the host name to the specified string. Both the API and lower-level system hostname are changed immediately. 
Prototype
void 
set_https_only 
(session ref , host ref , bool ) 
updates the host firewall to open or close port 80 depending on the value
Parameters: session ref session_id Reference to a valid session host ref self The Host bool value true - http port 80 will be blocked, false - http port 80 will be open Minimum role: pool-operator Prototyped in: XAPI 22.27.0 (22.27.0) 
void 
set_iscsi_iqn 
(session ref , host ref , string ) 
Sets the initiator IQN for the host
Parameters: session ref session_id Reference to a valid session host ref host The host string value The value to which the IQN should be set Minimum role: pool-operator Published in: XenServer 7.5 (kolkata) 
void 
set_license_server 
(session ref , host ref , (string → string) map ) 
Set the license_server field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object (string → string) map value New value to set Minimum role: pool-operator Published in: XenServer 5.6 (midnight-ride) Contact information of the license server 
void 
set_logging 
(session ref , host ref , (string → string) map ) 
Set the logging field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object (string → string) map value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) logging configuration 
void 
set_multipathing 
(session ref , host ref , bool ) 
Specifies whether multipathing is enabled
Parameters: session ref session_id Reference to a valid session host ref host The host bool value Whether multipathing should be enabled Minimum role: pool-operator Published in: XenServer 7.5 (kolkata) 
void 
set_name_description 
(session ref , host ref , string ) 
Set the name/description field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) a notes field containing human-readable description 
void 
set_name_label 
(session ref , host ref , string ) 
Set the name/label field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object string value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) a human-readable name 
Prototype
void 
set_numa_affinity_policy 
(session ref , host ref , enum host_numa_affinity_policy ) 
Set VM placement NUMA affinity policy
Parameters: session ref session_id Reference to a valid session host ref self The host enum host_numa_affinity_policy value The NUMA affinity policy to apply to a host Minimum role: pool-admin Prototyped in: XAPI 24.0.0 (24.0.0) 
void 
set_other_config 
(session ref , host ref , (string → string) map ) 
Set the other_config field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object (string → string) map value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) additional configuration 
void 
set_power_on_mode 
(session ref , host ref , string , (string → string) map ) 
Set the power-on-mode, host, user and password
Parameters: session ref session_id Reference to a valid session host ref self The host string power_on_mode power-on-mode can be empty, wake-on-lan, DRAC or other (string → string) map power_on_config Power on config Minimum role: pool-operator Published in: XenServer 5.6 FP1 (cowley) Changed in: Citrix Hypervisor 8.2 (stockholm) Removed iLO script 
void 
set_sched_gran 
(session ref , host ref , enum host_sched_gran ) 
Sets xen's sched-gran on a host. See: https://xenbits.xen.org/docs/unstable/misc/xen-command-line.html#sched-gran-x86
Parameters: session ref session_id Reference to a valid session host ref self The host enum host_sched_gran value The sched-gran to apply to a host Minimum role: Published in: XAPI 1.271.0 (1.271.0) 
void 
set_ssl_legacy 
(session ref , host ref , bool ) 
Enable/disable SSLv3 for interoperability with older server versions. When this is set to a different value, the host immediately restarts its SSL/TLS listening service; typically this takes less than a second but existing connections to it will be broken. API login sessions will remain valid.
Parameters: session ref session_id Reference to a valid session host ref self The host bool value True to allow SSLv3 and ciphersuites as used in old XenServer versions Minimum role: pool-operator Published in: XenServer 7.0 (dundee) Changed in: Citrix Hypervisor 8.2 (stockholm) Legacy SSL no longer supported 
void 
set_suspend_image_sr 
(session ref , host ref , SR ref ) 
Set the suspend_image_sr field of the given host.
Parameters: session ref session_id Reference to a valid session host ref self reference to the object SR ref value New value to set Minimum role: pool-operator Published in: XenServer 4.0 (rio) The SR in which VDIs for suspend images are created 
void 
set_tags 
(session ref , host ref , string set ) 
Deprecated
void 
set_uefi_certificates 
(session ref , host ref , string ) 
Sets the UEFI certificates on a host
Parameters: session ref session_id Reference to a valid session host ref host The host string value The certificates to apply to a host Minimum role: Published in: Citrix Hypervisor 8.1 (quebec) Deprecated in: XAPI 22.16.0 (22.16.0) Use Pool.set_uefi_certificates instead 
void 
shutdown 
(session ref , host ref ) 
Shutdown the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.)
Parameters: session ref session_id Reference to a valid session host ref host The Host to shutdown Minimum role: pool-operator Published in: XenServer 4.0 (rio) Shutdown the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.) 
void 
shutdown_agent 
(session ref ) 
Shuts the agent down after a 10 second pause. WARNING: this is a dangerous operation. Any operations in progress will be aborted, and unrecoverable data loss may occur. The caller is responsible for ensuring that there are no operations in progress when this method is called.
Parameters: session ref session_id Reference to a valid session Minimum role: pool-operator Published in: XenServer 5.0 (orlando) Shuts the agent down after a 10 second pause. WARNING: this is a dangerous operation. Any operations in progress will be aborted, and unrecoverable data loss may occur. The caller is responsible for ensuring that there are no operations in progress when this method is called. 
void 
sync_data 
(session ref , host ref ) 
This causes the synchronisation of the non-database data (messages, RRDs and so on) stored on the master to be synchronised with the host
Parameters: session ref session_id Reference to a valid session host ref host The host to whom the data should be sent Minimum role: pool-admin Published in: XenServer 5.0 (orlando) This causes the synchronisation of the non-database data (messages, RRDs and so on) stored on the master to be synchronised with the host 
void 
syslog_reconfigure 
(session ref , host ref )