/* * Copyright (c) Citrix Systems, Inc. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1) Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2) Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following * disclaimer in the documentation and/or other materials * provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED * OF THE POSSIBILITY OF SUCH DAMAGE. */ using System; using System.Collections; using System.Collections.Generic; using System.ComponentModel; using System.Globalization; using Newtonsoft.Json; namespace XenAPI { /// /// A virtual machine (or 'guest'). /// First published in XenServer 4.0. /// public partial class VM : XenObject { #region Constructors public VM() { } public VM(string uuid, List allowed_operations, Dictionary current_operations, vm_power_state power_state, string name_label, string name_description, long user_version, bool is_a_template, bool is_default_template, XenRef suspend_VDI, XenRef resident_on, XenRef affinity, long memory_overhead, long memory_target, long memory_static_max, long memory_dynamic_max, long memory_dynamic_min, long memory_static_min, Dictionary VCPUs_params, long VCPUs_max, long VCPUs_at_startup, on_normal_exit actions_after_shutdown, on_normal_exit actions_after_reboot, on_crash_behaviour actions_after_crash, List> consoles, List> VIFs, List> VBDs, List> VUSBs, List> crash_dumps, List> VTPMs, string PV_bootloader, string PV_kernel, string PV_ramdisk, string PV_args, string PV_bootloader_args, string PV_legacy_args, string HVM_boot_policy, Dictionary HVM_boot_params, double HVM_shadow_multiplier, Dictionary platform, string PCI_bus, Dictionary other_config, long domid, string domarch, Dictionary last_boot_CPU_flags, bool is_control_domain, XenRef metrics, XenRef guest_metrics, string last_booted_record, string recommendations, Dictionary xenstore_data, bool ha_always_run, string ha_restart_priority, bool is_a_snapshot, XenRef snapshot_of, List> snapshots, DateTime snapshot_time, string transportable_snapshot_id, Dictionary> blobs, string[] tags, Dictionary blocked_operations, Dictionary snapshot_info, string snapshot_metadata, XenRef parent, List> children, Dictionary bios_strings, XenRef protection_policy, bool is_snapshot_from_vmpp, XenRef snapshot_schedule, bool is_vmss_snapshot, XenRef appliance, long start_delay, long shutdown_delay, long order, List> VGPUs, List> attached_PCIs, XenRef suspend_SR, long version, string generation_id, long hardware_platform_version, bool has_vendor_device, bool requires_reboot, string reference_label, domain_type domain_type, Dictionary NVRAM) { this.uuid = uuid; this.allowed_operations = allowed_operations; this.current_operations = current_operations; this.power_state = power_state; this.name_label = name_label; this.name_description = name_description; this.user_version = user_version; this.is_a_template = is_a_template; this.is_default_template = is_default_template; this.suspend_VDI = suspend_VDI; this.resident_on = resident_on; this.affinity = affinity; this.memory_overhead = memory_overhead; this.memory_target = memory_target; this.memory_static_max = memory_static_max; this.memory_dynamic_max = memory_dynamic_max; this.memory_dynamic_min = memory_dynamic_min; this.memory_static_min = memory_static_min; this.VCPUs_params = VCPUs_params; this.VCPUs_max = VCPUs_max; this.VCPUs_at_startup = VCPUs_at_startup; this.actions_after_shutdown = actions_after_shutdown; this.actions_after_reboot = actions_after_reboot; this.actions_after_crash = actions_after_crash; this.consoles = consoles; this.VIFs = VIFs; this.VBDs = VBDs; this.VUSBs = VUSBs; this.crash_dumps = crash_dumps; this.VTPMs = VTPMs; this.PV_bootloader = PV_bootloader; this.PV_kernel = PV_kernel; this.PV_ramdisk = PV_ramdisk; this.PV_args = PV_args; this.PV_bootloader_args = PV_bootloader_args; this.PV_legacy_args = PV_legacy_args; this.HVM_boot_policy = HVM_boot_policy; this.HVM_boot_params = HVM_boot_params; this.HVM_shadow_multiplier = HVM_shadow_multiplier; this.platform = platform; this.PCI_bus = PCI_bus; this.other_config = other_config; this.domid = domid; this.domarch = domarch; this.last_boot_CPU_flags = last_boot_CPU_flags; this.is_control_domain = is_control_domain; this.metrics = metrics; this.guest_metrics = guest_metrics; this.last_booted_record = last_booted_record; this.recommendations = recommendations; this.xenstore_data = xenstore_data; this.ha_always_run = ha_always_run; this.ha_restart_priority = ha_restart_priority; this.is_a_snapshot = is_a_snapshot; this.snapshot_of = snapshot_of; this.snapshots = snapshots; this.snapshot_time = snapshot_time; this.transportable_snapshot_id = transportable_snapshot_id; this.blobs = blobs; this.tags = tags; this.blocked_operations = blocked_operations; this.snapshot_info = snapshot_info; this.snapshot_metadata = snapshot_metadata; this.parent = parent; this.children = children; this.bios_strings = bios_strings; this.protection_policy = protection_policy; this.is_snapshot_from_vmpp = is_snapshot_from_vmpp; this.snapshot_schedule = snapshot_schedule; this.is_vmss_snapshot = is_vmss_snapshot; this.appliance = appliance; this.start_delay = start_delay; this.shutdown_delay = shutdown_delay; this.order = order; this.VGPUs = VGPUs; this.attached_PCIs = attached_PCIs; this.suspend_SR = suspend_SR; this.version = version; this.generation_id = generation_id; this.hardware_platform_version = hardware_platform_version; this.has_vendor_device = has_vendor_device; this.requires_reboot = requires_reboot; this.reference_label = reference_label; this.domain_type = domain_type; this.NVRAM = NVRAM; } /// /// Creates a new VM from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public VM(Hashtable table) : this() { UpdateFrom(table); } /// /// Creates a new VM from a Proxy_VM. /// /// public VM(Proxy_VM proxy) { UpdateFrom(proxy); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given VM. /// public override void UpdateFrom(VM update) { uuid = update.uuid; allowed_operations = update.allowed_operations; current_operations = update.current_operations; power_state = update.power_state; name_label = update.name_label; name_description = update.name_description; user_version = update.user_version; is_a_template = update.is_a_template; is_default_template = update.is_default_template; suspend_VDI = update.suspend_VDI; resident_on = update.resident_on; affinity = update.affinity; memory_overhead = update.memory_overhead; memory_target = update.memory_target; memory_static_max = update.memory_static_max; memory_dynamic_max = update.memory_dynamic_max; memory_dynamic_min = update.memory_dynamic_min; memory_static_min = update.memory_static_min; VCPUs_params = update.VCPUs_params; VCPUs_max = update.VCPUs_max; VCPUs_at_startup = update.VCPUs_at_startup; actions_after_shutdown = update.actions_after_shutdown; actions_after_reboot = update.actions_after_reboot; actions_after_crash = update.actions_after_crash; consoles = update.consoles; VIFs = update.VIFs; VBDs = update.VBDs; VUSBs = update.VUSBs; crash_dumps = update.crash_dumps; VTPMs = update.VTPMs; PV_bootloader = update.PV_bootloader; PV_kernel = update.PV_kernel; PV_ramdisk = update.PV_ramdisk; PV_args = update.PV_args; PV_bootloader_args = update.PV_bootloader_args; PV_legacy_args = update.PV_legacy_args; HVM_boot_policy = update.HVM_boot_policy; HVM_boot_params = update.HVM_boot_params; HVM_shadow_multiplier = update.HVM_shadow_multiplier; platform = update.platform; PCI_bus = update.PCI_bus; other_config = update.other_config; domid = update.domid; domarch = update.domarch; last_boot_CPU_flags = update.last_boot_CPU_flags; is_control_domain = update.is_control_domain; metrics = update.metrics; guest_metrics = update.guest_metrics; last_booted_record = update.last_booted_record; recommendations = update.recommendations; xenstore_data = update.xenstore_data; ha_always_run = update.ha_always_run; ha_restart_priority = update.ha_restart_priority; is_a_snapshot = update.is_a_snapshot; snapshot_of = update.snapshot_of; snapshots = update.snapshots; snapshot_time = update.snapshot_time; transportable_snapshot_id = update.transportable_snapshot_id; blobs = update.blobs; tags = update.tags; blocked_operations = update.blocked_operations; snapshot_info = update.snapshot_info; snapshot_metadata = update.snapshot_metadata; parent = update.parent; children = update.children; bios_strings = update.bios_strings; protection_policy = update.protection_policy; is_snapshot_from_vmpp = update.is_snapshot_from_vmpp; snapshot_schedule = update.snapshot_schedule; is_vmss_snapshot = update.is_vmss_snapshot; appliance = update.appliance; start_delay = update.start_delay; shutdown_delay = update.shutdown_delay; order = update.order; VGPUs = update.VGPUs; attached_PCIs = update.attached_PCIs; suspend_SR = update.suspend_SR; version = update.version; generation_id = update.generation_id; hardware_platform_version = update.hardware_platform_version; has_vendor_device = update.has_vendor_device; requires_reboot = update.requires_reboot; reference_label = update.reference_label; domain_type = update.domain_type; NVRAM = update.NVRAM; } internal void UpdateFrom(Proxy_VM proxy) { uuid = proxy.uuid == null ? null : proxy.uuid; allowed_operations = proxy.allowed_operations == null ? null : Helper.StringArrayToEnumList(proxy.allowed_operations); current_operations = proxy.current_operations == null ? null : Maps.convert_from_proxy_string_vm_operations(proxy.current_operations); power_state = proxy.power_state == null ? (vm_power_state) 0 : (vm_power_state)Helper.EnumParseDefault(typeof(vm_power_state), (string)proxy.power_state); name_label = proxy.name_label == null ? null : proxy.name_label; name_description = proxy.name_description == null ? null : proxy.name_description; user_version = proxy.user_version == null ? 0 : long.Parse(proxy.user_version); is_a_template = (bool)proxy.is_a_template; is_default_template = (bool)proxy.is_default_template; suspend_VDI = proxy.suspend_VDI == null ? null : XenRef.Create(proxy.suspend_VDI); resident_on = proxy.resident_on == null ? null : XenRef.Create(proxy.resident_on); affinity = proxy.affinity == null ? null : XenRef.Create(proxy.affinity); memory_overhead = proxy.memory_overhead == null ? 0 : long.Parse(proxy.memory_overhead); memory_target = proxy.memory_target == null ? 0 : long.Parse(proxy.memory_target); memory_static_max = proxy.memory_static_max == null ? 0 : long.Parse(proxy.memory_static_max); memory_dynamic_max = proxy.memory_dynamic_max == null ? 0 : long.Parse(proxy.memory_dynamic_max); memory_dynamic_min = proxy.memory_dynamic_min == null ? 0 : long.Parse(proxy.memory_dynamic_min); memory_static_min = proxy.memory_static_min == null ? 0 : long.Parse(proxy.memory_static_min); VCPUs_params = proxy.VCPUs_params == null ? null : Maps.convert_from_proxy_string_string(proxy.VCPUs_params); VCPUs_max = proxy.VCPUs_max == null ? 0 : long.Parse(proxy.VCPUs_max); VCPUs_at_startup = proxy.VCPUs_at_startup == null ? 0 : long.Parse(proxy.VCPUs_at_startup); actions_after_shutdown = proxy.actions_after_shutdown == null ? (on_normal_exit) 0 : (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), (string)proxy.actions_after_shutdown); actions_after_reboot = proxy.actions_after_reboot == null ? (on_normal_exit) 0 : (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), (string)proxy.actions_after_reboot); actions_after_crash = proxy.actions_after_crash == null ? (on_crash_behaviour) 0 : (on_crash_behaviour)Helper.EnumParseDefault(typeof(on_crash_behaviour), (string)proxy.actions_after_crash); consoles = proxy.consoles == null ? null : XenRef.Create(proxy.consoles); VIFs = proxy.VIFs == null ? null : XenRef.Create(proxy.VIFs); VBDs = proxy.VBDs == null ? null : XenRef.Create(proxy.VBDs); VUSBs = proxy.VUSBs == null ? null : XenRef.Create(proxy.VUSBs); crash_dumps = proxy.crash_dumps == null ? null : XenRef.Create(proxy.crash_dumps); VTPMs = proxy.VTPMs == null ? null : XenRef.Create(proxy.VTPMs); PV_bootloader = proxy.PV_bootloader == null ? null : proxy.PV_bootloader; PV_kernel = proxy.PV_kernel == null ? null : proxy.PV_kernel; PV_ramdisk = proxy.PV_ramdisk == null ? null : proxy.PV_ramdisk; PV_args = proxy.PV_args == null ? null : proxy.PV_args; PV_bootloader_args = proxy.PV_bootloader_args == null ? null : proxy.PV_bootloader_args; PV_legacy_args = proxy.PV_legacy_args == null ? null : proxy.PV_legacy_args; HVM_boot_policy = proxy.HVM_boot_policy == null ? null : proxy.HVM_boot_policy; HVM_boot_params = proxy.HVM_boot_params == null ? null : Maps.convert_from_proxy_string_string(proxy.HVM_boot_params); HVM_shadow_multiplier = Convert.ToDouble(proxy.HVM_shadow_multiplier); platform = proxy.platform == null ? null : Maps.convert_from_proxy_string_string(proxy.platform); PCI_bus = proxy.PCI_bus == null ? null : proxy.PCI_bus; other_config = proxy.other_config == null ? null : Maps.convert_from_proxy_string_string(proxy.other_config); domid = proxy.domid == null ? 0 : long.Parse(proxy.domid); domarch = proxy.domarch == null ? null : proxy.domarch; last_boot_CPU_flags = proxy.last_boot_CPU_flags == null ? null : Maps.convert_from_proxy_string_string(proxy.last_boot_CPU_flags); is_control_domain = (bool)proxy.is_control_domain; metrics = proxy.metrics == null ? null : XenRef.Create(proxy.metrics); guest_metrics = proxy.guest_metrics == null ? null : XenRef.Create(proxy.guest_metrics); last_booted_record = proxy.last_booted_record == null ? null : proxy.last_booted_record; recommendations = proxy.recommendations == null ? null : proxy.recommendations; xenstore_data = proxy.xenstore_data == null ? null : Maps.convert_from_proxy_string_string(proxy.xenstore_data); ha_always_run = (bool)proxy.ha_always_run; ha_restart_priority = proxy.ha_restart_priority == null ? null : proxy.ha_restart_priority; is_a_snapshot = (bool)proxy.is_a_snapshot; snapshot_of = proxy.snapshot_of == null ? null : XenRef.Create(proxy.snapshot_of); snapshots = proxy.snapshots == null ? null : XenRef.Create(proxy.snapshots); snapshot_time = proxy.snapshot_time; transportable_snapshot_id = proxy.transportable_snapshot_id == null ? null : proxy.transportable_snapshot_id; blobs = proxy.blobs == null ? null : Maps.convert_from_proxy_string_XenRefBlob(proxy.blobs); tags = proxy.tags == null ? new string[] {} : (string [])proxy.tags; blocked_operations = proxy.blocked_operations == null ? null : Maps.convert_from_proxy_vm_operations_string(proxy.blocked_operations); snapshot_info = proxy.snapshot_info == null ? null : Maps.convert_from_proxy_string_string(proxy.snapshot_info); snapshot_metadata = proxy.snapshot_metadata == null ? null : proxy.snapshot_metadata; parent = proxy.parent == null ? null : XenRef.Create(proxy.parent); children = proxy.children == null ? null : XenRef.Create(proxy.children); bios_strings = proxy.bios_strings == null ? null : Maps.convert_from_proxy_string_string(proxy.bios_strings); protection_policy = proxy.protection_policy == null ? null : XenRef.Create(proxy.protection_policy); is_snapshot_from_vmpp = (bool)proxy.is_snapshot_from_vmpp; snapshot_schedule = proxy.snapshot_schedule == null ? null : XenRef.Create(proxy.snapshot_schedule); is_vmss_snapshot = (bool)proxy.is_vmss_snapshot; appliance = proxy.appliance == null ? null : XenRef.Create(proxy.appliance); start_delay = proxy.start_delay == null ? 0 : long.Parse(proxy.start_delay); shutdown_delay = proxy.shutdown_delay == null ? 0 : long.Parse(proxy.shutdown_delay); order = proxy.order == null ? 0 : long.Parse(proxy.order); VGPUs = proxy.VGPUs == null ? null : XenRef.Create(proxy.VGPUs); attached_PCIs = proxy.attached_PCIs == null ? null : XenRef.Create(proxy.attached_PCIs); suspend_SR = proxy.suspend_SR == null ? null : XenRef.Create(proxy.suspend_SR); version = proxy.version == null ? 0 : long.Parse(proxy.version); generation_id = proxy.generation_id == null ? null : proxy.generation_id; hardware_platform_version = proxy.hardware_platform_version == null ? 0 : long.Parse(proxy.hardware_platform_version); has_vendor_device = (bool)proxy.has_vendor_device; requires_reboot = (bool)proxy.requires_reboot; reference_label = proxy.reference_label == null ? null : proxy.reference_label; domain_type = proxy.domain_type == null ? (domain_type) 0 : (domain_type)Helper.EnumParseDefault(typeof(domain_type), (string)proxy.domain_type); NVRAM = proxy.NVRAM == null ? null : Maps.convert_from_proxy_string_string(proxy.NVRAM); } public Proxy_VM ToProxy() { Proxy_VM result_ = new Proxy_VM(); result_.uuid = uuid ?? ""; result_.allowed_operations = allowed_operations == null ? new string[] {} : Helper.ObjectListToStringArray(allowed_operations); result_.current_operations = Maps.convert_to_proxy_string_vm_operations(current_operations); result_.power_state = vm_power_state_helper.ToString(power_state); result_.name_label = name_label ?? ""; result_.name_description = name_description ?? ""; result_.user_version = user_version.ToString(); result_.is_a_template = is_a_template; result_.is_default_template = is_default_template; result_.suspend_VDI = suspend_VDI ?? ""; result_.resident_on = resident_on ?? ""; result_.affinity = affinity ?? ""; result_.memory_overhead = memory_overhead.ToString(); result_.memory_target = memory_target.ToString(); result_.memory_static_max = memory_static_max.ToString(); result_.memory_dynamic_max = memory_dynamic_max.ToString(); result_.memory_dynamic_min = memory_dynamic_min.ToString(); result_.memory_static_min = memory_static_min.ToString(); result_.VCPUs_params = Maps.convert_to_proxy_string_string(VCPUs_params); result_.VCPUs_max = VCPUs_max.ToString(); result_.VCPUs_at_startup = VCPUs_at_startup.ToString(); result_.actions_after_shutdown = on_normal_exit_helper.ToString(actions_after_shutdown); result_.actions_after_reboot = on_normal_exit_helper.ToString(actions_after_reboot); result_.actions_after_crash = on_crash_behaviour_helper.ToString(actions_after_crash); result_.consoles = consoles == null ? new string[] {} : Helper.RefListToStringArray(consoles); result_.VIFs = VIFs == null ? new string[] {} : Helper.RefListToStringArray(VIFs); result_.VBDs = VBDs == null ? new string[] {} : Helper.RefListToStringArray(VBDs); result_.VUSBs = VUSBs == null ? new string[] {} : Helper.RefListToStringArray(VUSBs); result_.crash_dumps = crash_dumps == null ? new string[] {} : Helper.RefListToStringArray(crash_dumps); result_.VTPMs = VTPMs == null ? new string[] {} : Helper.RefListToStringArray(VTPMs); result_.PV_bootloader = PV_bootloader ?? ""; result_.PV_kernel = PV_kernel ?? ""; result_.PV_ramdisk = PV_ramdisk ?? ""; result_.PV_args = PV_args ?? ""; result_.PV_bootloader_args = PV_bootloader_args ?? ""; result_.PV_legacy_args = PV_legacy_args ?? ""; result_.HVM_boot_policy = HVM_boot_policy ?? ""; result_.HVM_boot_params = Maps.convert_to_proxy_string_string(HVM_boot_params); result_.HVM_shadow_multiplier = HVM_shadow_multiplier; result_.platform = Maps.convert_to_proxy_string_string(platform); result_.PCI_bus = PCI_bus ?? ""; result_.other_config = Maps.convert_to_proxy_string_string(other_config); result_.domid = domid.ToString(); result_.domarch = domarch ?? ""; result_.last_boot_CPU_flags = Maps.convert_to_proxy_string_string(last_boot_CPU_flags); result_.is_control_domain = is_control_domain; result_.metrics = metrics ?? ""; result_.guest_metrics = guest_metrics ?? ""; result_.last_booted_record = last_booted_record ?? ""; result_.recommendations = recommendations ?? ""; result_.xenstore_data = Maps.convert_to_proxy_string_string(xenstore_data); result_.ha_always_run = ha_always_run; result_.ha_restart_priority = ha_restart_priority ?? ""; result_.is_a_snapshot = is_a_snapshot; result_.snapshot_of = snapshot_of ?? ""; result_.snapshots = snapshots == null ? new string[] {} : Helper.RefListToStringArray(snapshots); result_.snapshot_time = snapshot_time; result_.transportable_snapshot_id = transportable_snapshot_id ?? ""; result_.blobs = Maps.convert_to_proxy_string_XenRefBlob(blobs); result_.tags = tags; result_.blocked_operations = Maps.convert_to_proxy_vm_operations_string(blocked_operations); result_.snapshot_info = Maps.convert_to_proxy_string_string(snapshot_info); result_.snapshot_metadata = snapshot_metadata ?? ""; result_.parent = parent ?? ""; result_.children = children == null ? new string[] {} : Helper.RefListToStringArray(children); result_.bios_strings = Maps.convert_to_proxy_string_string(bios_strings); result_.protection_policy = protection_policy ?? ""; result_.is_snapshot_from_vmpp = is_snapshot_from_vmpp; result_.snapshot_schedule = snapshot_schedule ?? ""; result_.is_vmss_snapshot = is_vmss_snapshot; result_.appliance = appliance ?? ""; result_.start_delay = start_delay.ToString(); result_.shutdown_delay = shutdown_delay.ToString(); result_.order = order.ToString(); result_.VGPUs = VGPUs == null ? new string[] {} : Helper.RefListToStringArray(VGPUs); result_.attached_PCIs = attached_PCIs == null ? new string[] {} : Helper.RefListToStringArray(attached_PCIs); result_.suspend_SR = suspend_SR ?? ""; result_.version = version.ToString(); result_.generation_id = generation_id ?? ""; result_.hardware_platform_version = hardware_platform_version.ToString(); result_.has_vendor_device = has_vendor_device; result_.requires_reboot = requires_reboot; result_.reference_label = reference_label ?? ""; result_.domain_type = domain_type_helper.ToString(domain_type); result_.NVRAM = Maps.convert_to_proxy_string_string(NVRAM); return result_; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this VM /// with the values listed in the Hashtable. Note that only the fields contained /// in the Hashtable will be updated and the rest will remain the same. /// /// public void UpdateFrom(Hashtable table) { if (table.ContainsKey("uuid")) uuid = Marshalling.ParseString(table, "uuid"); if (table.ContainsKey("allowed_operations")) allowed_operations = Helper.StringArrayToEnumList(Marshalling.ParseStringArray(table, "allowed_operations")); if (table.ContainsKey("current_operations")) current_operations = Maps.convert_from_proxy_string_vm_operations(Marshalling.ParseHashTable(table, "current_operations")); if (table.ContainsKey("power_state")) power_state = (vm_power_state)Helper.EnumParseDefault(typeof(vm_power_state), Marshalling.ParseString(table, "power_state")); if (table.ContainsKey("name_label")) name_label = Marshalling.ParseString(table, "name_label"); if (table.ContainsKey("name_description")) name_description = Marshalling.ParseString(table, "name_description"); if (table.ContainsKey("user_version")) user_version = Marshalling.ParseLong(table, "user_version"); if (table.ContainsKey("is_a_template")) is_a_template = Marshalling.ParseBool(table, "is_a_template"); if (table.ContainsKey("is_default_template")) is_default_template = Marshalling.ParseBool(table, "is_default_template"); if (table.ContainsKey("suspend_VDI")) suspend_VDI = Marshalling.ParseRef(table, "suspend_VDI"); if (table.ContainsKey("resident_on")) resident_on = Marshalling.ParseRef(table, "resident_on"); if (table.ContainsKey("affinity")) affinity = Marshalling.ParseRef(table, "affinity"); if (table.ContainsKey("memory_overhead")) memory_overhead = Marshalling.ParseLong(table, "memory_overhead"); if (table.ContainsKey("memory_target")) memory_target = Marshalling.ParseLong(table, "memory_target"); if (table.ContainsKey("memory_static_max")) memory_static_max = Marshalling.ParseLong(table, "memory_static_max"); if (table.ContainsKey("memory_dynamic_max")) memory_dynamic_max = Marshalling.ParseLong(table, "memory_dynamic_max"); if (table.ContainsKey("memory_dynamic_min")) memory_dynamic_min = Marshalling.ParseLong(table, "memory_dynamic_min"); if (table.ContainsKey("memory_static_min")) memory_static_min = Marshalling.ParseLong(table, "memory_static_min"); if (table.ContainsKey("VCPUs_params")) VCPUs_params = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "VCPUs_params")); if (table.ContainsKey("VCPUs_max")) VCPUs_max = Marshalling.ParseLong(table, "VCPUs_max"); if (table.ContainsKey("VCPUs_at_startup")) VCPUs_at_startup = Marshalling.ParseLong(table, "VCPUs_at_startup"); if (table.ContainsKey("actions_after_shutdown")) actions_after_shutdown = (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), Marshalling.ParseString(table, "actions_after_shutdown")); if (table.ContainsKey("actions_after_reboot")) actions_after_reboot = (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), Marshalling.ParseString(table, "actions_after_reboot")); if (table.ContainsKey("actions_after_crash")) actions_after_crash = (on_crash_behaviour)Helper.EnumParseDefault(typeof(on_crash_behaviour), Marshalling.ParseString(table, "actions_after_crash")); if (table.ContainsKey("consoles")) consoles = Marshalling.ParseSetRef(table, "consoles"); if (table.ContainsKey("VIFs")) VIFs = Marshalling.ParseSetRef(table, "VIFs"); if (table.ContainsKey("VBDs")) VBDs = Marshalling.ParseSetRef(table, "VBDs"); if (table.ContainsKey("VUSBs")) VUSBs = Marshalling.ParseSetRef(table, "VUSBs"); if (table.ContainsKey("crash_dumps")) crash_dumps = Marshalling.ParseSetRef(table, "crash_dumps"); if (table.ContainsKey("VTPMs")) VTPMs = Marshalling.ParseSetRef(table, "VTPMs"); if (table.ContainsKey("PV_bootloader")) PV_bootloader = Marshalling.ParseString(table, "PV_bootloader"); if (table.ContainsKey("PV_kernel")) PV_kernel = Marshalling.ParseString(table, "PV_kernel"); if (table.ContainsKey("PV_ramdisk")) PV_ramdisk = Marshalling.ParseString(table, "PV_ramdisk"); if (table.ContainsKey("PV_args")) PV_args = Marshalling.ParseString(table, "PV_args"); if (table.ContainsKey("PV_bootloader_args")) PV_bootloader_args = Marshalling.ParseString(table, "PV_bootloader_args"); if (table.ContainsKey("PV_legacy_args")) PV_legacy_args = Marshalling.ParseString(table, "PV_legacy_args"); if (table.ContainsKey("HVM_boot_policy")) HVM_boot_policy = Marshalling.ParseString(table, "HVM_boot_policy"); if (table.ContainsKey("HVM_boot_params")) HVM_boot_params = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "HVM_boot_params")); if (table.ContainsKey("HVM_shadow_multiplier")) HVM_shadow_multiplier = Marshalling.ParseDouble(table, "HVM_shadow_multiplier"); if (table.ContainsKey("platform")) platform = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "platform")); if (table.ContainsKey("PCI_bus")) PCI_bus = Marshalling.ParseString(table, "PCI_bus"); if (table.ContainsKey("other_config")) other_config = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "other_config")); if (table.ContainsKey("domid")) domid = Marshalling.ParseLong(table, "domid"); if (table.ContainsKey("domarch")) domarch = Marshalling.ParseString(table, "domarch"); if (table.ContainsKey("last_boot_CPU_flags")) last_boot_CPU_flags = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "last_boot_CPU_flags")); if (table.ContainsKey("is_control_domain")) is_control_domain = Marshalling.ParseBool(table, "is_control_domain"); if (table.ContainsKey("metrics")) metrics = Marshalling.ParseRef(table, "metrics"); if (table.ContainsKey("guest_metrics")) guest_metrics = Marshalling.ParseRef(table, "guest_metrics"); if (table.ContainsKey("last_booted_record")) last_booted_record = Marshalling.ParseString(table, "last_booted_record"); if (table.ContainsKey("recommendations")) recommendations = Marshalling.ParseString(table, "recommendations"); if (table.ContainsKey("xenstore_data")) xenstore_data = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "xenstore_data")); if (table.ContainsKey("ha_always_run")) ha_always_run = Marshalling.ParseBool(table, "ha_always_run"); if (table.ContainsKey("ha_restart_priority")) ha_restart_priority = Marshalling.ParseString(table, "ha_restart_priority"); if (table.ContainsKey("is_a_snapshot")) is_a_snapshot = Marshalling.ParseBool(table, "is_a_snapshot"); if (table.ContainsKey("snapshot_of")) snapshot_of = Marshalling.ParseRef(table, "snapshot_of"); if (table.ContainsKey("snapshots")) snapshots = Marshalling.ParseSetRef(table, "snapshots"); if (table.ContainsKey("snapshot_time")) snapshot_time = Marshalling.ParseDateTime(table, "snapshot_time"); if (table.ContainsKey("transportable_snapshot_id")) transportable_snapshot_id = Marshalling.ParseString(table, "transportable_snapshot_id"); if (table.ContainsKey("blobs")) blobs = Maps.convert_from_proxy_string_XenRefBlob(Marshalling.ParseHashTable(table, "blobs")); if (table.ContainsKey("tags")) tags = Marshalling.ParseStringArray(table, "tags"); if (table.ContainsKey("blocked_operations")) blocked_operations = Maps.convert_from_proxy_vm_operations_string(Marshalling.ParseHashTable(table, "blocked_operations")); if (table.ContainsKey("snapshot_info")) snapshot_info = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "snapshot_info")); if (table.ContainsKey("snapshot_metadata")) snapshot_metadata = Marshalling.ParseString(table, "snapshot_metadata"); if (table.ContainsKey("parent")) parent = Marshalling.ParseRef(table, "parent"); if (table.ContainsKey("children")) children = Marshalling.ParseSetRef(table, "children"); if (table.ContainsKey("bios_strings")) bios_strings = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "bios_strings")); if (table.ContainsKey("protection_policy")) protection_policy = Marshalling.ParseRef(table, "protection_policy"); if (table.ContainsKey("is_snapshot_from_vmpp")) is_snapshot_from_vmpp = Marshalling.ParseBool(table, "is_snapshot_from_vmpp"); if (table.ContainsKey("snapshot_schedule")) snapshot_schedule = Marshalling.ParseRef(table, "snapshot_schedule"); if (table.ContainsKey("is_vmss_snapshot")) is_vmss_snapshot = Marshalling.ParseBool(table, "is_vmss_snapshot"); if (table.ContainsKey("appliance")) appliance = Marshalling.ParseRef(table, "appliance"); if (table.ContainsKey("start_delay")) start_delay = Marshalling.ParseLong(table, "start_delay"); if (table.ContainsKey("shutdown_delay")) shutdown_delay = Marshalling.ParseLong(table, "shutdown_delay"); if (table.ContainsKey("order")) order = Marshalling.ParseLong(table, "order"); if (table.ContainsKey("VGPUs")) VGPUs = Marshalling.ParseSetRef(table, "VGPUs"); if (table.ContainsKey("attached_PCIs")) attached_PCIs = Marshalling.ParseSetRef(table, "attached_PCIs"); if (table.ContainsKey("suspend_SR")) suspend_SR = Marshalling.ParseRef(table, "suspend_SR"); if (table.ContainsKey("version")) version = Marshalling.ParseLong(table, "version"); if (table.ContainsKey("generation_id")) generation_id = Marshalling.ParseString(table, "generation_id"); if (table.ContainsKey("hardware_platform_version")) hardware_platform_version = Marshalling.ParseLong(table, "hardware_platform_version"); if (table.ContainsKey("has_vendor_device")) has_vendor_device = Marshalling.ParseBool(table, "has_vendor_device"); if (table.ContainsKey("requires_reboot")) requires_reboot = Marshalling.ParseBool(table, "requires_reboot"); if (table.ContainsKey("reference_label")) reference_label = Marshalling.ParseString(table, "reference_label"); if (table.ContainsKey("domain_type")) domain_type = (domain_type)Helper.EnumParseDefault(typeof(domain_type), Marshalling.ParseString(table, "domain_type")); if (table.ContainsKey("NVRAM")) NVRAM = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "NVRAM")); } public bool DeepEquals(VM other, bool ignoreCurrentOperations) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; if (!ignoreCurrentOperations && !Helper.AreEqual2(this.current_operations, other.current_operations)) return false; return Helper.AreEqual2(this._uuid, other._uuid) && Helper.AreEqual2(this._allowed_operations, other._allowed_operations) && Helper.AreEqual2(this._power_state, other._power_state) && Helper.AreEqual2(this._name_label, other._name_label) && Helper.AreEqual2(this._name_description, other._name_description) && Helper.AreEqual2(this._user_version, other._user_version) && Helper.AreEqual2(this._is_a_template, other._is_a_template) && Helper.AreEqual2(this._is_default_template, other._is_default_template) && Helper.AreEqual2(this._suspend_VDI, other._suspend_VDI) && Helper.AreEqual2(this._resident_on, other._resident_on) && Helper.AreEqual2(this._affinity, other._affinity) && Helper.AreEqual2(this._memory_overhead, other._memory_overhead) && Helper.AreEqual2(this._memory_target, other._memory_target) && Helper.AreEqual2(this._memory_static_max, other._memory_static_max) && Helper.AreEqual2(this._memory_dynamic_max, other._memory_dynamic_max) && Helper.AreEqual2(this._memory_dynamic_min, other._memory_dynamic_min) && Helper.AreEqual2(this._memory_static_min, other._memory_static_min) && Helper.AreEqual2(this._VCPUs_params, other._VCPUs_params) && Helper.AreEqual2(this._VCPUs_max, other._VCPUs_max) && Helper.AreEqual2(this._VCPUs_at_startup, other._VCPUs_at_startup) && Helper.AreEqual2(this._actions_after_shutdown, other._actions_after_shutdown) && Helper.AreEqual2(this._actions_after_reboot, other._actions_after_reboot) && Helper.AreEqual2(this._actions_after_crash, other._actions_after_crash) && Helper.AreEqual2(this._consoles, other._consoles) && Helper.AreEqual2(this._VIFs, other._VIFs) && Helper.AreEqual2(this._VBDs, other._VBDs) && Helper.AreEqual2(this._VUSBs, other._VUSBs) && Helper.AreEqual2(this._crash_dumps, other._crash_dumps) && Helper.AreEqual2(this._VTPMs, other._VTPMs) && Helper.AreEqual2(this._PV_bootloader, other._PV_bootloader) && Helper.AreEqual2(this._PV_kernel, other._PV_kernel) && Helper.AreEqual2(this._PV_ramdisk, other._PV_ramdisk) && Helper.AreEqual2(this._PV_args, other._PV_args) && Helper.AreEqual2(this._PV_bootloader_args, other._PV_bootloader_args) && Helper.AreEqual2(this._PV_legacy_args, other._PV_legacy_args) && Helper.AreEqual2(this._HVM_boot_policy, other._HVM_boot_policy) && Helper.AreEqual2(this._HVM_boot_params, other._HVM_boot_params) && Helper.AreEqual2(this._HVM_shadow_multiplier, other._HVM_shadow_multiplier) && Helper.AreEqual2(this._platform, other._platform) && Helper.AreEqual2(this._PCI_bus, other._PCI_bus) && Helper.AreEqual2(this._other_config, other._other_config) && Helper.AreEqual2(this._domid, other._domid) && Helper.AreEqual2(this._domarch, other._domarch) && Helper.AreEqual2(this._last_boot_CPU_flags, other._last_boot_CPU_flags) && Helper.AreEqual2(this._is_control_domain, other._is_control_domain) && Helper.AreEqual2(this._metrics, other._metrics) && Helper.AreEqual2(this._guest_metrics, other._guest_metrics) && Helper.AreEqual2(this._last_booted_record, other._last_booted_record) && Helper.AreEqual2(this._recommendations, other._recommendations) && Helper.AreEqual2(this._xenstore_data, other._xenstore_data) && Helper.AreEqual2(this._ha_always_run, other._ha_always_run) && Helper.AreEqual2(this._ha_restart_priority, other._ha_restart_priority) && Helper.AreEqual2(this._is_a_snapshot, other._is_a_snapshot) && Helper.AreEqual2(this._snapshot_of, other._snapshot_of) && Helper.AreEqual2(this._snapshots, other._snapshots) && Helper.AreEqual2(this._snapshot_time, other._snapshot_time) && Helper.AreEqual2(this._transportable_snapshot_id, other._transportable_snapshot_id) && Helper.AreEqual2(this._blobs, other._blobs) && Helper.AreEqual2(this._tags, other._tags) && Helper.AreEqual2(this._blocked_operations, other._blocked_operations) && Helper.AreEqual2(this._snapshot_info, other._snapshot_info) && Helper.AreEqual2(this._snapshot_metadata, other._snapshot_metadata) && Helper.AreEqual2(this._parent, other._parent) && Helper.AreEqual2(this._children, other._children) && Helper.AreEqual2(this._bios_strings, other._bios_strings) && Helper.AreEqual2(this._protection_policy, other._protection_policy) && Helper.AreEqual2(this._is_snapshot_from_vmpp, other._is_snapshot_from_vmpp) && Helper.AreEqual2(this._snapshot_schedule, other._snapshot_schedule) && Helper.AreEqual2(this._is_vmss_snapshot, other._is_vmss_snapshot) && Helper.AreEqual2(this._appliance, other._appliance) && Helper.AreEqual2(this._start_delay, other._start_delay) && Helper.AreEqual2(this._shutdown_delay, other._shutdown_delay) && Helper.AreEqual2(this._order, other._order) && Helper.AreEqual2(this._VGPUs, other._VGPUs) && Helper.AreEqual2(this._attached_PCIs, other._attached_PCIs) && Helper.AreEqual2(this._suspend_SR, other._suspend_SR) && Helper.AreEqual2(this._version, other._version) && Helper.AreEqual2(this._generation_id, other._generation_id) && Helper.AreEqual2(this._hardware_platform_version, other._hardware_platform_version) && Helper.AreEqual2(this._has_vendor_device, other._has_vendor_device) && Helper.AreEqual2(this._requires_reboot, other._requires_reboot) && Helper.AreEqual2(this._reference_label, other._reference_label) && Helper.AreEqual2(this._domain_type, other._domain_type) && Helper.AreEqual2(this._NVRAM, other._NVRAM); } internal static List ProxyArrayToObjectList(Proxy_VM[] input) { var result = new List(); foreach (var item in input) result.Add(new VM(item)); return result; } public override string SaveChanges(Session session, string opaqueRef, VM server) { if (opaqueRef == null) { var reference = create(session, this); return reference == null ? null : reference.opaque_ref; } else { if (!Helper.AreEqual2(_name_label, server._name_label)) { VM.set_name_label(session, opaqueRef, _name_label); } if (!Helper.AreEqual2(_name_description, server._name_description)) { VM.set_name_description(session, opaqueRef, _name_description); } if (!Helper.AreEqual2(_user_version, server._user_version)) { VM.set_user_version(session, opaqueRef, _user_version); } if (!Helper.AreEqual2(_is_a_template, server._is_a_template)) { VM.set_is_a_template(session, opaqueRef, _is_a_template); } if (!Helper.AreEqual2(_affinity, server._affinity)) { VM.set_affinity(session, opaqueRef, _affinity); } if (!Helper.AreEqual2(_VCPUs_params, server._VCPUs_params)) { VM.set_VCPUs_params(session, opaqueRef, _VCPUs_params); } if (!Helper.AreEqual2(_actions_after_shutdown, server._actions_after_shutdown)) { VM.set_actions_after_shutdown(session, opaqueRef, _actions_after_shutdown); } if (!Helper.AreEqual2(_actions_after_reboot, server._actions_after_reboot)) { VM.set_actions_after_reboot(session, opaqueRef, _actions_after_reboot); } if (!Helper.AreEqual2(_PV_bootloader, server._PV_bootloader)) { VM.set_PV_bootloader(session, opaqueRef, _PV_bootloader); } if (!Helper.AreEqual2(_PV_kernel, server._PV_kernel)) { VM.set_PV_kernel(session, opaqueRef, _PV_kernel); } if (!Helper.AreEqual2(_PV_ramdisk, server._PV_ramdisk)) { VM.set_PV_ramdisk(session, opaqueRef, _PV_ramdisk); } if (!Helper.AreEqual2(_PV_args, server._PV_args)) { VM.set_PV_args(session, opaqueRef, _PV_args); } if (!Helper.AreEqual2(_PV_bootloader_args, server._PV_bootloader_args)) { VM.set_PV_bootloader_args(session, opaqueRef, _PV_bootloader_args); } if (!Helper.AreEqual2(_PV_legacy_args, server._PV_legacy_args)) { VM.set_PV_legacy_args(session, opaqueRef, _PV_legacy_args); } if (!Helper.AreEqual2(_HVM_boot_params, server._HVM_boot_params)) { VM.set_HVM_boot_params(session, opaqueRef, _HVM_boot_params); } if (!Helper.AreEqual2(_platform, server._platform)) { VM.set_platform(session, opaqueRef, _platform); } if (!Helper.AreEqual2(_PCI_bus, server._PCI_bus)) { VM.set_PCI_bus(session, opaqueRef, _PCI_bus); } if (!Helper.AreEqual2(_other_config, server._other_config)) { VM.set_other_config(session, opaqueRef, _other_config); } if (!Helper.AreEqual2(_recommendations, server._recommendations)) { VM.set_recommendations(session, opaqueRef, _recommendations); } if (!Helper.AreEqual2(_xenstore_data, server._xenstore_data)) { VM.set_xenstore_data(session, opaqueRef, _xenstore_data); } if (!Helper.AreEqual2(_tags, server._tags)) { VM.set_tags(session, opaqueRef, _tags); } if (!Helper.AreEqual2(_blocked_operations, server._blocked_operations)) { VM.set_blocked_operations(session, opaqueRef, _blocked_operations); } if (!Helper.AreEqual2(_suspend_SR, server._suspend_SR)) { VM.set_suspend_SR(session, opaqueRef, _suspend_SR); } if (!Helper.AreEqual2(_hardware_platform_version, server._hardware_platform_version)) { VM.set_hardware_platform_version(session, opaqueRef, _hardware_platform_version); } if (!Helper.AreEqual2(_memory_static_max, server._memory_static_max)) { VM.set_memory_static_max(session, opaqueRef, _memory_static_max); } if (!Helper.AreEqual2(_memory_dynamic_max, server._memory_dynamic_max)) { VM.set_memory_dynamic_max(session, opaqueRef, _memory_dynamic_max); } if (!Helper.AreEqual2(_memory_dynamic_min, server._memory_dynamic_min)) { VM.set_memory_dynamic_min(session, opaqueRef, _memory_dynamic_min); } if (!Helper.AreEqual2(_memory_static_min, server._memory_static_min)) { VM.set_memory_static_min(session, opaqueRef, _memory_static_min); } if (!Helper.AreEqual2(_VCPUs_max, server._VCPUs_max)) { VM.set_VCPUs_max(session, opaqueRef, _VCPUs_max); } if (!Helper.AreEqual2(_VCPUs_at_startup, server._VCPUs_at_startup)) { VM.set_VCPUs_at_startup(session, opaqueRef, _VCPUs_at_startup); } if (!Helper.AreEqual2(_actions_after_crash, server._actions_after_crash)) { VM.set_actions_after_crash(session, opaqueRef, _actions_after_crash); } if (!Helper.AreEqual2(_HVM_boot_policy, server._HVM_boot_policy)) { VM.set_HVM_boot_policy(session, opaqueRef, _HVM_boot_policy); } if (!Helper.AreEqual2(_HVM_shadow_multiplier, server._HVM_shadow_multiplier)) { VM.set_HVM_shadow_multiplier(session, opaqueRef, _HVM_shadow_multiplier); } if (!Helper.AreEqual2(_ha_always_run, server._ha_always_run)) { VM.set_ha_always_run(session, opaqueRef, _ha_always_run); } if (!Helper.AreEqual2(_ha_restart_priority, server._ha_restart_priority)) { VM.set_ha_restart_priority(session, opaqueRef, _ha_restart_priority); } if (!Helper.AreEqual2(_protection_policy, server._protection_policy)) { VM.set_protection_policy(session, opaqueRef, _protection_policy); } if (!Helper.AreEqual2(_snapshot_schedule, server._snapshot_schedule)) { VM.set_snapshot_schedule(session, opaqueRef, _snapshot_schedule); } if (!Helper.AreEqual2(_appliance, server._appliance)) { VM.set_appliance(session, opaqueRef, _appliance); } if (!Helper.AreEqual2(_start_delay, server._start_delay)) { VM.set_start_delay(session, opaqueRef, _start_delay); } if (!Helper.AreEqual2(_shutdown_delay, server._shutdown_delay)) { VM.set_shutdown_delay(session, opaqueRef, _shutdown_delay); } if (!Helper.AreEqual2(_order, server._order)) { VM.set_order(session, opaqueRef, _order); } if (!Helper.AreEqual2(_has_vendor_device, server._has_vendor_device)) { VM.set_has_vendor_device(session, opaqueRef, _has_vendor_device); } if (!Helper.AreEqual2(_domain_type, server._domain_type)) { VM.set_domain_type(session, opaqueRef, _domain_type); } if (!Helper.AreEqual2(_NVRAM, server._NVRAM)) { VM.set_NVRAM(session, opaqueRef, _NVRAM); } return null; } } /// /// Get a record containing the current state of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static VM get_record(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_record(session.opaque_ref, _vm); else return new VM(session.proxy.vm_get_record(session.opaque_ref, _vm ?? "").parse()); } /// /// Get a reference to the VM instance with the specified UUID. /// First published in XenServer 4.0. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_by_uuid(session.opaque_ref, _uuid); else return XenRef.Create(session.proxy.vm_get_by_uuid(session.opaque_ref, _uuid ?? "").parse()); } /// /// NOT RECOMMENDED! VM.clone or VM.copy (or VM.import) is a better choice in almost all situations. The standard way to obtain a new VM is to call VM.clone on a template VM, then call VM.provision on the new clone. Caution: if VM.create is used and then the new VM is attached to a virtual disc that has an operating system already installed, then there is no guarantee that the operating system will boot and run. Any software that calls VM.create on a future version of this API may fail or give unexpected results. For example this could happen if an additional parameter were added to VM.create. VM.create is intended only for use in the automatic creation of the system VM templates. It creates a new VM instance, and returns its handle. /// First published in XenServer 4.0. /// /// The session /// All constructor arguments public static XenRef create(Session session, VM _record) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_create(session.opaque_ref, _record); else return XenRef.Create(session.proxy.vm_create(session.opaque_ref, _record.ToProxy()).parse()); } /// /// NOT RECOMMENDED! VM.clone or VM.copy (or VM.import) is a better choice in almost all situations. The standard way to obtain a new VM is to call VM.clone on a template VM, then call VM.provision on the new clone. Caution: if VM.create is used and then the new VM is attached to a virtual disc that has an operating system already installed, then there is no guarantee that the operating system will boot and run. Any software that calls VM.create on a future version of this API may fail or give unexpected results. For example this could happen if an additional parameter were added to VM.create. VM.create is intended only for use in the automatic creation of the system VM templates. It creates a new VM instance, and returns its handle. /// First published in XenServer 4.0. /// /// The session /// All constructor arguments public static XenRef async_create(Session session, VM _record) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_create(session.opaque_ref, _record); else return XenRef.Create(session.proxy.async_vm_create(session.opaque_ref, _record.ToProxy()).parse()); } /// /// Destroy the specified VM. The VM is completely removed from the system. This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void destroy(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_destroy(session.opaque_ref, _vm); else session.proxy.vm_destroy(session.opaque_ref, _vm ?? "").parse(); } /// /// Destroy the specified VM. The VM is completely removed from the system. This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_destroy(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_destroy(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_destroy(session.opaque_ref, _vm ?? "").parse()); } /// /// Get all the VM instances with the given label. /// First published in XenServer 4.0. /// /// The session /// label of object to return public static List> get_by_name_label(Session session, string _label) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_by_name_label(session.opaque_ref, _label); else return XenRef.Create(session.proxy.vm_get_by_name_label(session.opaque_ref, _label ?? "").parse()); } /// /// Get the uuid field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_uuid(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_uuid(session.opaque_ref, _vm); else return session.proxy.vm_get_uuid(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the allowed_operations field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List get_allowed_operations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_allowed_operations(session.opaque_ref, _vm); else return Helper.StringArrayToEnumList(session.proxy.vm_get_allowed_operations(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the current_operations field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_current_operations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_current_operations(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_vm_operations(session.proxy.vm_get_current_operations(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the power_state field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static vm_power_state get_power_state(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_power_state(session.opaque_ref, _vm); else return (vm_power_state)Helper.EnumParseDefault(typeof(vm_power_state), (string)session.proxy.vm_get_power_state(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the name/label field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_name_label(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_name_label(session.opaque_ref, _vm); else return session.proxy.vm_get_name_label(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the name/description field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_name_description(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_name_description(session.opaque_ref, _vm); else return session.proxy.vm_get_name_description(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the user_version field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_user_version(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_user_version(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_user_version(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the is_a_template field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static bool get_is_a_template(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_a_template(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_a_template(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the is_default_template field of the given VM. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vm public static bool get_is_default_template(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_default_template(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_default_template(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the suspend_VDI field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_suspend_VDI(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_suspend_vdi(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_suspend_vdi(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the resident_on field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_resident_on(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_resident_on(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_resident_on(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the affinity field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_affinity(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_affinity(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_affinity(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/overhead field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_memory_overhead(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_overhead(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_overhead(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/target field of the given VM. /// First published in XenServer 4.0. /// Deprecated since XenServer 5.6. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 5.6")] public static long get_memory_target(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_target(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_target(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/static_max field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_memory_static_max(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_static_max(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_static_max(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/dynamic_max field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_memory_dynamic_max(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_dynamic_max(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_dynamic_max(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/dynamic_min field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_memory_dynamic_min(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_dynamic_min(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_dynamic_min(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the memory/static_min field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_memory_static_min(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_memory_static_min(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_memory_static_min(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VCPUs/params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_VCPUs_params(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vcpus_params(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_vcpus_params(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VCPUs/max field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_VCPUs_max(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vcpus_max(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_vcpus_max(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VCPUs/at_startup field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_VCPUs_at_startup(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vcpus_at_startup(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_vcpus_at_startup(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the actions/after_shutdown field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static on_normal_exit get_actions_after_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_actions_after_shutdown(session.opaque_ref, _vm); else return (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), (string)session.proxy.vm_get_actions_after_shutdown(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the actions/after_reboot field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static on_normal_exit get_actions_after_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_actions_after_reboot(session.opaque_ref, _vm); else return (on_normal_exit)Helper.EnumParseDefault(typeof(on_normal_exit), (string)session.proxy.vm_get_actions_after_reboot(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the actions/after_crash field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static on_crash_behaviour get_actions_after_crash(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_actions_after_crash(session.opaque_ref, _vm); else return (on_crash_behaviour)Helper.EnumParseDefault(typeof(on_crash_behaviour), (string)session.proxy.vm_get_actions_after_crash(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the consoles field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_consoles(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_consoles(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_consoles(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VIFs field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_VIFs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vifs(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_vifs(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VBDs field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_VBDs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vbds(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_vbds(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VUSBs field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_VUSBs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vusbs(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_vusbs(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the crash_dumps field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_crash_dumps(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_crash_dumps(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_crash_dumps(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VTPMs field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_VTPMs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vtpms(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_vtpms(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the PV/bootloader field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_bootloader(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_bootloader(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_bootloader(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the PV/kernel field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_kernel(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_kernel(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_kernel(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the PV/ramdisk field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_ramdisk(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_ramdisk(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_ramdisk(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the PV/args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_args(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_args(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_args(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the PV/bootloader_args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_bootloader_args(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_bootloader_args(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_bootloader_args(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the PV/legacy_args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_PV_legacy_args(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pv_legacy_args(session.opaque_ref, _vm); else return session.proxy.vm_get_pv_legacy_args(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the HVM/boot_policy field of the given VM. /// First published in XenServer 4.0. /// Deprecated since XenServer 7.5. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 7.5")] public static string get_HVM_boot_policy(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_hvm_boot_policy(session.opaque_ref, _vm); else return session.proxy.vm_get_hvm_boot_policy(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the HVM/boot_params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_HVM_boot_params(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_hvm_boot_params(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_hvm_boot_params(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the HVM/shadow_multiplier field of the given VM. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm public static double get_HVM_shadow_multiplier(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_hvm_shadow_multiplier(session.opaque_ref, _vm); else return Convert.ToDouble(session.proxy.vm_get_hvm_shadow_multiplier(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the platform field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_platform(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_platform(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_platform(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the PCI_bus field of the given VM. /// First published in XenServer 4.0. /// Deprecated since XenServer 6.0. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.0")] public static string get_PCI_bus(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_pci_bus(session.opaque_ref, _vm); else return session.proxy.vm_get_pci_bus(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the other_config field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_other_config(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_other_config(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_other_config(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the domid field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static long get_domid(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_domid(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_domid(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the domarch field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_domarch(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_domarch(session.opaque_ref, _vm); else return session.proxy.vm_get_domarch(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the last_boot_CPU_flags field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_last_boot_CPU_flags(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_last_boot_cpu_flags(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_last_boot_cpu_flags(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the is_control_domain field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static bool get_is_control_domain(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_control_domain(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_control_domain(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the metrics field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_metrics(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_metrics(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_metrics(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the guest_metrics field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_guest_metrics(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_guest_metrics(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_guest_metrics(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the last_booted_record field of the given VM. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm public static string get_last_booted_record(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_last_booted_record(session.opaque_ref, _vm); else return session.proxy.vm_get_last_booted_record(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the recommendations field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string get_recommendations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_recommendations(session.opaque_ref, _vm); else return session.proxy.vm_get_recommendations(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the xenstore_data field of the given VM. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_xenstore_data(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_xenstore_data(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_xenstore_data(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the ha_always_run field of the given VM. /// First published in XenServer 5.0. /// Deprecated since XenServer 6.0. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.0")] public static bool get_ha_always_run(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_ha_always_run(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_ha_always_run(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the ha_restart_priority field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static string get_ha_restart_priority(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_ha_restart_priority(session.opaque_ref, _vm); else return session.proxy.vm_get_ha_restart_priority(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the is_a_snapshot field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static bool get_is_a_snapshot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_a_snapshot(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_a_snapshot(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the snapshot_of field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_snapshot_of(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshot_of(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_snapshot_of(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the snapshots field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static List> get_snapshots(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshots(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_snapshots(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the snapshot_time field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static DateTime get_snapshot_time(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshot_time(session.opaque_ref, _vm); else return session.proxy.vm_get_snapshot_time(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the transportable_snapshot_id field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static string get_transportable_snapshot_id(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_transportable_snapshot_id(session.opaque_ref, _vm); else return session.proxy.vm_get_transportable_snapshot_id(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the blobs field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary> get_blobs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_blobs(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_XenRefBlob(session.proxy.vm_get_blobs(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the tags field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static string[] get_tags(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_tags(session.opaque_ref, _vm); else return (string [])session.proxy.vm_get_tags(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the blocked_operations field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_blocked_operations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_blocked_operations(session.opaque_ref, _vm); else return Maps.convert_from_proxy_vm_operations_string(session.proxy.vm_get_blocked_operations(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the snapshot_info field of the given VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_snapshot_info(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshot_info(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_snapshot_info(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the snapshot_metadata field of the given VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static string get_snapshot_metadata(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshot_metadata(session.opaque_ref, _vm); else return session.proxy.vm_get_snapshot_metadata(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the parent field of the given VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static XenRef get_parent(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_parent(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_parent(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the children field of the given VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static List> get_children(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_children(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_children(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the bios_strings field of the given VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_bios_strings(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_bios_strings(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_bios_strings(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the protection_policy field of the given VM. /// First published in XenServer 5.6 FP1. /// Deprecated since XenServer 6.2. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.2")] public static XenRef get_protection_policy(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_protection_policy(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_protection_policy(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the is_snapshot_from_vmpp field of the given VM. /// First published in XenServer 5.6 FP1. /// Deprecated since XenServer 6.2. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.2")] public static bool get_is_snapshot_from_vmpp(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_snapshot_from_vmpp(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_snapshot_from_vmpp(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the snapshot_schedule field of the given VM. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vm public static XenRef get_snapshot_schedule(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_snapshot_schedule(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_snapshot_schedule(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the is_vmss_snapshot field of the given VM. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vm public static bool get_is_vmss_snapshot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_is_vmss_snapshot(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_is_vmss_snapshot(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the appliance field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_appliance(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_appliance(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_appliance(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the start_delay field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static long get_start_delay(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_start_delay(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_start_delay(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the shutdown_delay field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static long get_shutdown_delay(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_shutdown_delay(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_shutdown_delay(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the order field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static long get_order(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_order(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_order(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the VGPUs field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static List> get_VGPUs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_vgpus(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_vgpus(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the attached_PCIs field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static List> get_attached_PCIs(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_attached_pcis(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_attached_pcis(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the suspend_SR field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static XenRef get_suspend_SR(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_suspend_sr(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_suspend_sr(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the version field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm public static long get_version(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_version(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_version(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the generation_id field of the given VM. /// First published in XenServer 6.2. /// /// The session /// The opaque_ref of the given vm public static string get_generation_id(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_generation_id(session.opaque_ref, _vm); else return session.proxy.vm_get_generation_id(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the hardware_platform_version field of the given VM. /// First published in XenServer 6.5 SP1. /// /// The session /// The opaque_ref of the given vm public static long get_hardware_platform_version(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_hardware_platform_version(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_get_hardware_platform_version(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the has_vendor_device field of the given VM. /// First published in XenServer 7.0. /// /// The session /// The opaque_ref of the given vm public static bool get_has_vendor_device(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_has_vendor_device(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_has_vendor_device(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the requires_reboot field of the given VM. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given vm public static bool get_requires_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_requires_reboot(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_requires_reboot(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the reference_label field of the given VM. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given vm public static string get_reference_label(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_reference_label(session.opaque_ref, _vm); else return session.proxy.vm_get_reference_label(session.opaque_ref, _vm ?? "").parse(); } /// /// Get the domain_type field of the given VM. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given vm public static domain_type get_domain_type(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_domain_type(session.opaque_ref, _vm); else return (domain_type)Helper.EnumParseDefault(typeof(domain_type), (string)session.proxy.vm_get_domain_type(session.opaque_ref, _vm ?? "").parse()); } /// /// Get the NVRAM field of the given VM. /// Experimental. First published in Citrix Hypervisor 8.0. /// /// The session /// The opaque_ref of the given vm public static Dictionary get_NVRAM(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_nvram(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_get_nvram(session.opaque_ref, _vm ?? "").parse()); } /// /// Set the name/label field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_name_label(Session session, string _vm, string _label) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_name_label(session.opaque_ref, _vm, _label); else session.proxy.vm_set_name_label(session.opaque_ref, _vm ?? "", _label ?? "").parse(); } /// /// Set the name/description field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_name_description(Session session, string _vm, string _description) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_name_description(session.opaque_ref, _vm, _description); else session.proxy.vm_set_name_description(session.opaque_ref, _vm ?? "", _description ?? "").parse(); } /// /// Set the user_version field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_user_version(Session session, string _vm, long _user_version) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_user_version(session.opaque_ref, _vm, _user_version); else session.proxy.vm_set_user_version(session.opaque_ref, _vm ?? "", _user_version.ToString()).parse(); } /// /// Set the is_a_template field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_is_a_template(Session session, string _vm, bool _is_a_template) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_is_a_template(session.opaque_ref, _vm, _is_a_template); else session.proxy.vm_set_is_a_template(session.opaque_ref, _vm ?? "", _is_a_template).parse(); } /// /// Set the affinity field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_affinity(Session session, string _vm, string _affinity) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_affinity(session.opaque_ref, _vm, _affinity); else session.proxy.vm_set_affinity(session.opaque_ref, _vm ?? "", _affinity ?? "").parse(); } /// /// Set the VCPUs/params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_VCPUs_params(Session session, string _vm, Dictionary _params) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_vcpus_params(session.opaque_ref, _vm, _params); else session.proxy.vm_set_vcpus_params(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_params)).parse(); } /// /// Add the given key-value pair to the VCPUs/params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_VCPUs_params(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_vcpus_params(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_vcpus_params(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the VCPUs/params field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_VCPUs_params(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_vcpus_params(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_vcpus_params(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the actions/after_shutdown field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_actions_after_shutdown(Session session, string _vm, on_normal_exit _after_shutdown) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_actions_after_shutdown(session.opaque_ref, _vm, _after_shutdown); else session.proxy.vm_set_actions_after_shutdown(session.opaque_ref, _vm ?? "", on_normal_exit_helper.ToString(_after_shutdown)).parse(); } /// /// Set the actions/after_reboot field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_actions_after_reboot(Session session, string _vm, on_normal_exit _after_reboot) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_actions_after_reboot(session.opaque_ref, _vm, _after_reboot); else session.proxy.vm_set_actions_after_reboot(session.opaque_ref, _vm ?? "", on_normal_exit_helper.ToString(_after_reboot)).parse(); } /// /// Set the PV/bootloader field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_bootloader(Session session, string _vm, string _bootloader) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_bootloader(session.opaque_ref, _vm, _bootloader); else session.proxy.vm_set_pv_bootloader(session.opaque_ref, _vm ?? "", _bootloader ?? "").parse(); } /// /// Set the PV/kernel field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_kernel(Session session, string _vm, string _kernel) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_kernel(session.opaque_ref, _vm, _kernel); else session.proxy.vm_set_pv_kernel(session.opaque_ref, _vm ?? "", _kernel ?? "").parse(); } /// /// Set the PV/ramdisk field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_ramdisk(Session session, string _vm, string _ramdisk) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_ramdisk(session.opaque_ref, _vm, _ramdisk); else session.proxy.vm_set_pv_ramdisk(session.opaque_ref, _vm ?? "", _ramdisk ?? "").parse(); } /// /// Set the PV/args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_args(Session session, string _vm, string _args) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_args(session.opaque_ref, _vm, _args); else session.proxy.vm_set_pv_args(session.opaque_ref, _vm ?? "", _args ?? "").parse(); } /// /// Set the PV/bootloader_args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_bootloader_args(Session session, string _vm, string _bootloader_args) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_bootloader_args(session.opaque_ref, _vm, _bootloader_args); else session.proxy.vm_set_pv_bootloader_args(session.opaque_ref, _vm ?? "", _bootloader_args ?? "").parse(); } /// /// Set the PV/legacy_args field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_PV_legacy_args(Session session, string _vm, string _legacy_args) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pv_legacy_args(session.opaque_ref, _vm, _legacy_args); else session.proxy.vm_set_pv_legacy_args(session.opaque_ref, _vm ?? "", _legacy_args ?? "").parse(); } /// /// Set the HVM/boot_params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_HVM_boot_params(Session session, string _vm, Dictionary _boot_params) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_hvm_boot_params(session.opaque_ref, _vm, _boot_params); else session.proxy.vm_set_hvm_boot_params(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_boot_params)).parse(); } /// /// Add the given key-value pair to the HVM/boot_params field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_HVM_boot_params(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_hvm_boot_params(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_hvm_boot_params(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the HVM/boot_params field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_HVM_boot_params(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_hvm_boot_params(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_hvm_boot_params(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the platform field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_platform(Session session, string _vm, Dictionary _platform) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_platform(session.opaque_ref, _vm, _platform); else session.proxy.vm_set_platform(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_platform)).parse(); } /// /// Add the given key-value pair to the platform field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_platform(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_platform(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_platform(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the platform field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_platform(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_platform(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_platform(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the PCI_bus field of the given VM. /// First published in XenServer 4.0. /// Deprecated since XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// New value to set [Deprecated("XenServer 6.0")] public static void set_PCI_bus(Session session, string _vm, string _pci_bus) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_pci_bus(session.opaque_ref, _vm, _pci_bus); else session.proxy.vm_set_pci_bus(session.opaque_ref, _vm ?? "", _pci_bus ?? "").parse(); } /// /// Set the other_config field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_other_config(Session session, string _vm, Dictionary _other_config) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_other_config(session.opaque_ref, _vm, _other_config); else session.proxy.vm_set_other_config(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_other_config)).parse(); } /// /// Add the given key-value pair to the other_config field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_other_config(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_other_config(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_other_config(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the other_config field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_other_config(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_other_config(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_other_config(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the recommendations field of the given VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_recommendations(Session session, string _vm, string _recommendations) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_recommendations(session.opaque_ref, _vm, _recommendations); else session.proxy.vm_set_recommendations(session.opaque_ref, _vm ?? "", _recommendations ?? "").parse(); } /// /// Set the xenstore_data field of the given VM. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_xenstore_data(Session session, string _vm, Dictionary _xenstore_data) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_xenstore_data(session.opaque_ref, _vm, _xenstore_data); else session.proxy.vm_set_xenstore_data(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_xenstore_data)).parse(); } /// /// Add the given key-value pair to the xenstore_data field of the given VM. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_xenstore_data(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_xenstore_data(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_xenstore_data(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the xenstore_data field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_xenstore_data(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_xenstore_data(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_xenstore_data(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the tags field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_tags(Session session, string _vm, string[] _tags) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_tags(session.opaque_ref, _vm, _tags); else session.proxy.vm_set_tags(session.opaque_ref, _vm ?? "", _tags).parse(); } /// /// Add the given value to the tags field of the given VM. If the value is already in that Set, then do nothing. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// New value to add public static void add_tags(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_tags(session.opaque_ref, _vm, _value); else session.proxy.vm_add_tags(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Remove the given value from the tags field of the given VM. If the value is not in that Set, then do nothing. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// Value to remove public static void remove_tags(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_tags(session.opaque_ref, _vm, _value); else session.proxy.vm_remove_tags(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Set the blocked_operations field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_blocked_operations(Session session, string _vm, Dictionary _blocked_operations) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_blocked_operations(session.opaque_ref, _vm, _blocked_operations); else session.proxy.vm_set_blocked_operations(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_vm_operations_string(_blocked_operations)).parse(); } /// /// Add the given key-value pair to the blocked_operations field of the given VM. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// Key to add /// Value to add public static void add_to_blocked_operations(Session session, string _vm, vm_operations _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_blocked_operations(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_blocked_operations(session.opaque_ref, _vm ?? "", vm_operations_helper.ToString(_key), _value ?? "").parse(); } /// /// Remove the given key and its corresponding value from the blocked_operations field of the given VM. If the key is not in that Map, then do nothing. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// Key to remove public static void remove_from_blocked_operations(Session session, string _vm, vm_operations _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_blocked_operations(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_blocked_operations(session.opaque_ref, _vm ?? "", vm_operations_helper.ToString(_key)).parse(); } /// /// Set the suspend_SR field of the given VM. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_suspend_SR(Session session, string _vm, string _suspend_sr) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_suspend_sr(session.opaque_ref, _vm, _suspend_sr); else session.proxy.vm_set_suspend_sr(session.opaque_ref, _vm ?? "", _suspend_sr ?? "").parse(); } /// /// Set the hardware_platform_version field of the given VM. /// First published in XenServer 6.5 SP1. /// /// The session /// The opaque_ref of the given vm /// New value to set public static void set_hardware_platform_version(Session session, string _vm, long _hardware_platform_version) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_hardware_platform_version(session.opaque_ref, _vm, _hardware_platform_version); else session.proxy.vm_set_hardware_platform_version(session.opaque_ref, _vm ?? "", _hardware_platform_version.ToString()).parse(); } /// /// Snapshots the specified VM, making a new VM. Snapshot automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name of the snapshotted VM public static XenRef snapshot(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_snapshot(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.vm_snapshot(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Snapshots the specified VM, making a new VM. Snapshot automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name of the snapshotted VM public static XenRef async_snapshot(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_snapshot(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.async_vm_snapshot(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Snapshots the specified VM with quiesce, making a new VM. Snapshot automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name of the snapshotted VM public static XenRef snapshot_with_quiesce(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_snapshot_with_quiesce(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.vm_snapshot_with_quiesce(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Snapshots the specified VM with quiesce, making a new VM. Snapshot automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name of the snapshotted VM public static XenRef async_snapshot_with_quiesce(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_snapshot_with_quiesce(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.async_vm_snapshot_with_quiesce(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Clones the specified VM, making a new VM. Clone automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The name of the cloned VM public static XenRef clone(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_clone(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.vm_clone(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Clones the specified VM, making a new VM. Clone automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The name of the cloned VM public static XenRef async_clone(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_clone(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.async_vm_clone(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Copied the specified VM, making a new VM. Unlike clone, copy does not exploits the capabilities of the underlying storage repository in which the VM's disk images are stored. Instead, copy guarantees that the disk images of the newly created VM will be 'full disks' - i.e. not part of a CoW chain. This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The name of the copied VM /// An SR to copy all the VM's disks into (if an invalid reference then it uses the existing SRs) public static XenRef copy(Session session, string _vm, string _new_name, string _sr) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_copy(session.opaque_ref, _vm, _new_name, _sr); else return XenRef.Create(session.proxy.vm_copy(session.opaque_ref, _vm ?? "", _new_name ?? "", _sr ?? "").parse()); } /// /// Copied the specified VM, making a new VM. Unlike clone, copy does not exploits the capabilities of the underlying storage repository in which the VM's disk images are stored. Instead, copy guarantees that the disk images of the newly created VM will be 'full disks' - i.e. not part of a CoW chain. This function can only be called when the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The name of the copied VM /// An SR to copy all the VM's disks into (if an invalid reference then it uses the existing SRs) public static XenRef async_copy(Session session, string _vm, string _new_name, string _sr) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_copy(session.opaque_ref, _vm, _new_name, _sr); else return XenRef.Create(session.proxy.async_vm_copy(session.opaque_ref, _vm ?? "", _new_name ?? "", _sr ?? "").parse()); } /// /// Reverts the specified VM to a previous state. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given snapshotted state public static void revert(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_revert(session.opaque_ref, _vm); else session.proxy.vm_revert(session.opaque_ref, _vm ?? "").parse(); } /// /// Reverts the specified VM to a previous state. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given snapshotted state public static XenRef async_revert(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_revert(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_revert(session.opaque_ref, _vm ?? "").parse()); } /// /// Checkpoints the specified VM, making a new VM. Checkpoint automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write) and saves the memory image as well. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The name of the checkpointed VM public static XenRef checkpoint(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_checkpoint(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.vm_checkpoint(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Checkpoints the specified VM, making a new VM. Checkpoint automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write) and saves the memory image as well. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The name of the checkpointed VM public static XenRef async_checkpoint(Session session, string _vm, string _new_name) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_checkpoint(session.opaque_ref, _vm, _new_name); else return XenRef.Create(session.proxy.async_vm_checkpoint(session.opaque_ref, _vm ?? "", _new_name ?? "").parse()); } /// /// Inspects the disk configuration contained within the VM's other_config, creates VDIs and VBDs and then executes any applicable post-install script. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void provision(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_provision(session.opaque_ref, _vm); else session.proxy.vm_provision(session.opaque_ref, _vm ?? "").parse(); } /// /// Inspects the disk configuration contained within the VM's other_config, creates VDIs and VBDs and then executes any applicable post-install script. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_provision(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_provision(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_provision(session.opaque_ref, _vm ?? "").parse()); } /// /// Start the specified VM. This function can only be called with the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Instantiate VM in paused state if set to true. /// Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) public static void start(Session session, string _vm, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_start(session.opaque_ref, _vm, _start_paused, _force); else session.proxy.vm_start(session.opaque_ref, _vm ?? "", _start_paused, _force).parse(); } /// /// Start the specified VM. This function can only be called with the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Instantiate VM in paused state if set to true. /// Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) public static XenRef async_start(Session session, string _vm, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_start(session.opaque_ref, _vm, _start_paused, _force); else return XenRef.Create(session.proxy.async_vm_start(session.opaque_ref, _vm ?? "", _start_paused, _force).parse()); } /// /// Start the specified VM on a particular host. This function can only be called with the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The Host on which to start the VM /// Instantiate VM in paused state if set to true. /// Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) public static void start_on(Session session, string _vm, string _host, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_start_on(session.opaque_ref, _vm, _host, _start_paused, _force); else session.proxy.vm_start_on(session.opaque_ref, _vm ?? "", _host ?? "", _start_paused, _force).parse(); } /// /// Start the specified VM on a particular host. This function can only be called with the VM is in the Halted State. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The Host on which to start the VM /// Instantiate VM in paused state if set to true. /// Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) public static XenRef async_start_on(Session session, string _vm, string _host, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_start_on(session.opaque_ref, _vm, _host, _start_paused, _force); else return XenRef.Create(session.proxy.async_vm_start_on(session.opaque_ref, _vm ?? "", _host ?? "", _start_paused, _force).parse()); } /// /// Pause the specified VM. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void pause(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_pause(session.opaque_ref, _vm); else session.proxy.vm_pause(session.opaque_ref, _vm ?? "").parse(); } /// /// Pause the specified VM. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_pause(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_pause(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_pause(session.opaque_ref, _vm ?? "").parse()); } /// /// Resume the specified VM. This can only be called when the specified VM is in the Paused state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void unpause(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_unpause(session.opaque_ref, _vm); else session.proxy.vm_unpause(session.opaque_ref, _vm ?? "").parse(); } /// /// Resume the specified VM. This can only be called when the specified VM is in the Paused state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_unpause(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_unpause(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_unpause(session.opaque_ref, _vm ?? "").parse()); } /// /// Attempt to cleanly shutdown the specified VM. (Note: this may not be supported---e.g. if a guest agent is not installed). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void clean_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_clean_shutdown(session.opaque_ref, _vm); else session.proxy.vm_clean_shutdown(session.opaque_ref, _vm ?? "").parse(); } /// /// Attempt to cleanly shutdown the specified VM. (Note: this may not be supported---e.g. if a guest agent is not installed). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_clean_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_clean_shutdown(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_clean_shutdown(session.opaque_ref, _vm ?? "").parse()); } /// /// Attempts to first clean shutdown a VM and if it should fail then perform a hard shutdown on it. /// First published in XenServer 6.2. /// /// The session /// The opaque_ref of the given vm public static void shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_shutdown(session.opaque_ref, _vm); else session.proxy.vm_shutdown(session.opaque_ref, _vm ?? "").parse(); } /// /// Attempts to first clean shutdown a VM and if it should fail then perform a hard shutdown on it. /// First published in XenServer 6.2. /// /// The session /// The opaque_ref of the given vm public static XenRef async_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_shutdown(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_shutdown(session.opaque_ref, _vm ?? "").parse()); } /// /// Attempt to cleanly shutdown the specified VM (Note: this may not be supported---e.g. if a guest agent is not installed). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void clean_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_clean_reboot(session.opaque_ref, _vm); else session.proxy.vm_clean_reboot(session.opaque_ref, _vm ?? "").parse(); } /// /// Attempt to cleanly shutdown the specified VM (Note: this may not be supported---e.g. if a guest agent is not installed). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_clean_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_clean_reboot(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_clean_reboot(session.opaque_ref, _vm ?? "").parse()); } /// /// Stop executing the specified VM without attempting a clean shutdown. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void hard_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_hard_shutdown(session.opaque_ref, _vm); else session.proxy.vm_hard_shutdown(session.opaque_ref, _vm ?? "").parse(); } /// /// Stop executing the specified VM without attempting a clean shutdown. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_hard_shutdown(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_hard_shutdown(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_hard_shutdown(session.opaque_ref, _vm ?? "").parse()); } /// /// Reset the power-state of the VM to halted in the database only. (Used to recover from slave failures in pooling scenarios by resetting the power-states of VMs running on dead slaves to halted.) This is a potentially dangerous operation; use with care. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void power_state_reset(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_power_state_reset(session.opaque_ref, _vm); else session.proxy.vm_power_state_reset(session.opaque_ref, _vm ?? "").parse(); } /// /// Reset the power-state of the VM to halted in the database only. (Used to recover from slave failures in pooling scenarios by resetting the power-states of VMs running on dead slaves to halted.) This is a potentially dangerous operation; use with care. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_power_state_reset(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_power_state_reset(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_power_state_reset(session.opaque_ref, _vm ?? "").parse()); } /// /// Stop executing the specified VM without attempting a clean shutdown and immediately restart the VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void hard_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_hard_reboot(session.opaque_ref, _vm); else session.proxy.vm_hard_reboot(session.opaque_ref, _vm ?? "").parse(); } /// /// Stop executing the specified VM without attempting a clean shutdown and immediately restart the VM. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_hard_reboot(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_hard_reboot(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_hard_reboot(session.opaque_ref, _vm ?? "").parse()); } /// /// Suspend the specified VM to disk. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void suspend(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_suspend(session.opaque_ref, _vm); else session.proxy.vm_suspend(session.opaque_ref, _vm ?? "").parse(); } /// /// Suspend the specified VM to disk. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_suspend(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_suspend(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_suspend(session.opaque_ref, _vm ?? "").parse()); } /// /// Awaken the specified VM and resume it. This can only be called when the specified VM is in the Suspended state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Resume VM in paused state if set to true. /// Attempt to force the VM to resume. If this flag is false then the VM may fail pre-resume safety checks (e.g. if the CPU the VM was running on looks substantially different to the current one) public static void resume(Session session, string _vm, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_resume(session.opaque_ref, _vm, _start_paused, _force); else session.proxy.vm_resume(session.opaque_ref, _vm ?? "", _start_paused, _force).parse(); } /// /// Awaken the specified VM and resume it. This can only be called when the specified VM is in the Suspended state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// Resume VM in paused state if set to true. /// Attempt to force the VM to resume. If this flag is false then the VM may fail pre-resume safety checks (e.g. if the CPU the VM was running on looks substantially different to the current one) public static XenRef async_resume(Session session, string _vm, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_resume(session.opaque_ref, _vm, _start_paused, _force); else return XenRef.Create(session.proxy.async_vm_resume(session.opaque_ref, _vm ?? "", _start_paused, _force).parse()); } /// /// Awaken the specified VM and resume it on a particular Host. This can only be called when the specified VM is in the Suspended state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The Host on which to resume the VM /// Resume VM in paused state if set to true. /// Attempt to force the VM to resume. If this flag is false then the VM may fail pre-resume safety checks (e.g. if the CPU the VM was running on looks substantially different to the current one) public static void resume_on(Session session, string _vm, string _host, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_resume_on(session.opaque_ref, _vm, _host, _start_paused, _force); else session.proxy.vm_resume_on(session.opaque_ref, _vm ?? "", _host ?? "", _start_paused, _force).parse(); } /// /// Awaken the specified VM and resume it on a particular Host. This can only be called when the specified VM is in the Suspended state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The Host on which to resume the VM /// Resume VM in paused state if set to true. /// Attempt to force the VM to resume. If this flag is false then the VM may fail pre-resume safety checks (e.g. if the CPU the VM was running on looks substantially different to the current one) public static XenRef async_resume_on(Session session, string _vm, string _host, bool _start_paused, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_resume_on(session.opaque_ref, _vm, _host, _start_paused, _force); else return XenRef.Create(session.proxy.async_vm_resume_on(session.opaque_ref, _vm ?? "", _host ?? "", _start_paused, _force).parse()); } /// /// Migrate a VM to another Host. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The target host /// Extra configuration operations public static void pool_migrate(Session session, string _vm, string _host, Dictionary _options) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_pool_migrate(session.opaque_ref, _vm, _host, _options); else session.proxy.vm_pool_migrate(session.opaque_ref, _vm ?? "", _host ?? "", Maps.convert_to_proxy_string_string(_options)).parse(); } /// /// Migrate a VM to another Host. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The target host /// Extra configuration operations public static XenRef async_pool_migrate(Session session, string _vm, string _host, Dictionary _options) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_pool_migrate(session.opaque_ref, _vm, _host, _options); else return XenRef.Create(session.proxy.async_vm_pool_migrate(session.opaque_ref, _vm ?? "", _host ?? "", Maps.convert_to_proxy_string_string(_options)).parse()); } /// /// Set the number of VCPUs for a running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The number of VCPUs public static void set_VCPUs_number_live(Session session, string _vm, long _nvcpu) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_vcpus_number_live(session.opaque_ref, _vm, _nvcpu); else session.proxy.vm_set_vcpus_number_live(session.opaque_ref, _vm ?? "", _nvcpu.ToString()).parse(); } /// /// Set the number of VCPUs for a running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The number of VCPUs public static XenRef async_set_VCPUs_number_live(Session session, string _vm, long _nvcpu) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_vcpus_number_live(session.opaque_ref, _vm, _nvcpu); else return XenRef.Create(session.proxy.async_vm_set_vcpus_number_live(session.opaque_ref, _vm ?? "", _nvcpu.ToString()).parse()); } /// /// Add the given key-value pair to VM.VCPUs_params, and apply that value on the running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The key /// The value public static void add_to_VCPUs_params_live(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_vcpus_params_live(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_vcpus_params_live(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// Add the given key-value pair to VM.VCPUs_params, and apply that value on the running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The key /// The value public static XenRef async_add_to_VCPUs_params_live(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_add_to_vcpus_params_live(session.opaque_ref, _vm, _key, _value); else return XenRef.Create(session.proxy.async_vm_add_to_vcpus_params_live(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse()); } /// /// /// Experimental. First published in Citrix Hypervisor 8.0. /// /// The session /// The opaque_ref of the given vm /// The value public static void set_NVRAM(Session session, string _vm, Dictionary _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_nvram(session.opaque_ref, _vm, _value); else session.proxy.vm_set_nvram(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_value)).parse(); } /// /// /// Experimental. First published in Citrix Hypervisor 8.0. /// /// The session /// The opaque_ref of the given vm /// The key /// The value public static void add_to_NVRAM(Session session, string _vm, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_add_to_nvram(session.opaque_ref, _vm, _key, _value); else session.proxy.vm_add_to_nvram(session.opaque_ref, _vm ?? "", _key ?? "", _value ?? "").parse(); } /// /// /// Experimental. First published in Citrix Hypervisor 8.0. /// /// The session /// The opaque_ref of the given vm /// The key public static void remove_from_NVRAM(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_remove_from_nvram(session.opaque_ref, _vm, _key); else session.proxy.vm_remove_from_nvram(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Set the value of the ha_restart_priority field /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The value public static void set_ha_restart_priority(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_ha_restart_priority(session.opaque_ref, _vm, _value); else session.proxy.vm_set_ha_restart_priority(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Set the value of the ha_always_run /// First published in XenServer 5.0. /// Deprecated since XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The value [Deprecated("XenServer 6.0")] public static void set_ha_always_run(Session session, string _vm, bool _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_ha_always_run(session.opaque_ref, _vm, _value); else session.proxy.vm_set_ha_always_run(session.opaque_ref, _vm ?? "", _value).parse(); } /// /// Computes the virtualization memory overhead of a VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static long compute_memory_overhead(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_compute_memory_overhead(session.opaque_ref, _vm); else return long.Parse(session.proxy.vm_compute_memory_overhead(session.opaque_ref, _vm ?? "").parse()); } /// /// Computes the virtualization memory overhead of a VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm public static XenRef async_compute_memory_overhead(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_compute_memory_overhead(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_compute_memory_overhead(session.opaque_ref, _vm ?? "").parse()); } /// /// Set the value of the memory_dynamic_max field /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_dynamic_max public static void set_memory_dynamic_max(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_dynamic_max(session.opaque_ref, _vm, _value); else session.proxy.vm_set_memory_dynamic_max(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the value of the memory_dynamic_min field /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_dynamic_min public static void set_memory_dynamic_min(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_dynamic_min(session.opaque_ref, _vm, _value); else session.proxy.vm_set_memory_dynamic_min(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the minimum and maximum amounts of physical memory the VM is allowed to use. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new minimum value /// The new maximum value public static void set_memory_dynamic_range(Session session, string _vm, long _min, long _max) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_dynamic_range(session.opaque_ref, _vm, _min, _max); else session.proxy.vm_set_memory_dynamic_range(session.opaque_ref, _vm ?? "", _min.ToString(), _max.ToString()).parse(); } /// /// Set the minimum and maximum amounts of physical memory the VM is allowed to use. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new minimum value /// The new maximum value public static XenRef async_set_memory_dynamic_range(Session session, string _vm, long _min, long _max) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_memory_dynamic_range(session.opaque_ref, _vm, _min, _max); else return XenRef.Create(session.proxy.async_vm_set_memory_dynamic_range(session.opaque_ref, _vm ?? "", _min.ToString(), _max.ToString()).parse()); } /// /// Set the value of the memory_static_max field /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_static_max public static void set_memory_static_max(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_static_max(session.opaque_ref, _vm, _value); else session.proxy.vm_set_memory_static_max(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the value of the memory_static_min field /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_static_min public static void set_memory_static_min(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_static_min(session.opaque_ref, _vm, _value); else session.proxy.vm_set_memory_static_min(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the static (ie boot-time) range of virtual memory that the VM is allowed to use. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new minimum value /// The new maximum value public static void set_memory_static_range(Session session, string _vm, long _min, long _max) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_static_range(session.opaque_ref, _vm, _min, _max); else session.proxy.vm_set_memory_static_range(session.opaque_ref, _vm ?? "", _min.ToString(), _max.ToString()).parse(); } /// /// Set the static (ie boot-time) range of virtual memory that the VM is allowed to use. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new minimum value /// The new maximum value public static XenRef async_set_memory_static_range(Session session, string _vm, long _min, long _max) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_memory_static_range(session.opaque_ref, _vm, _min, _max); else return XenRef.Create(session.proxy.async_vm_set_memory_static_range(session.opaque_ref, _vm ?? "", _min.ToString(), _max.ToString()).parse()); } /// /// Set the memory limits of this VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_static_min. /// The new value of memory_static_max. /// The new value of memory_dynamic_min. /// The new value of memory_dynamic_max. public static void set_memory_limits(Session session, string _vm, long _static_min, long _static_max, long _dynamic_min, long _dynamic_max) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_limits(session.opaque_ref, _vm, _static_min, _static_max, _dynamic_min, _dynamic_max); else session.proxy.vm_set_memory_limits(session.opaque_ref, _vm ?? "", _static_min.ToString(), _static_max.ToString(), _dynamic_min.ToString(), _dynamic_max.ToString()).parse(); } /// /// Set the memory limits of this VM. /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new value of memory_static_min. /// The new value of memory_static_max. /// The new value of memory_dynamic_min. /// The new value of memory_dynamic_max. public static XenRef async_set_memory_limits(Session session, string _vm, long _static_min, long _static_max, long _dynamic_min, long _dynamic_max) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_memory_limits(session.opaque_ref, _vm, _static_min, _static_max, _dynamic_min, _dynamic_max); else return XenRef.Create(session.proxy.async_vm_set_memory_limits(session.opaque_ref, _vm ?? "", _static_min.ToString(), _static_max.ToString(), _dynamic_min.ToString(), _dynamic_max.ToString()).parse()); } /// /// Set the memory allocation of this VM. Sets all of memory_static_max, memory_dynamic_min, and memory_dynamic_max to the given value, and leaves memory_static_min untouched. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given vm /// The new memory allocation (bytes). public static void set_memory(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory(session.opaque_ref, _vm, _value); else session.proxy.vm_set_memory(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the memory allocation of this VM. Sets all of memory_static_max, memory_dynamic_min, and memory_dynamic_max to the given value, and leaves memory_static_min untouched. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given vm /// The new memory allocation (bytes). public static XenRef async_set_memory(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_memory(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_memory(session.opaque_ref, _vm ?? "", _value.ToString()).parse()); } /// /// Set the memory target for a running VM /// First published in XenServer 4.0. /// Deprecated since XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The target in bytes [Deprecated("XenServer 5.6")] public static void set_memory_target_live(Session session, string _vm, long _target) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_memory_target_live(session.opaque_ref, _vm, _target); else session.proxy.vm_set_memory_target_live(session.opaque_ref, _vm ?? "", _target.ToString()).parse(); } /// /// Set the memory target for a running VM /// First published in XenServer 4.0. /// Deprecated since XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The target in bytes [Deprecated("XenServer 5.6")] public static XenRef async_set_memory_target_live(Session session, string _vm, long _target) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_memory_target_live(session.opaque_ref, _vm, _target); else return XenRef.Create(session.proxy.async_vm_set_memory_target_live(session.opaque_ref, _vm ?? "", _target.ToString()).parse()); } /// /// Wait for a running VM to reach its current memory target /// First published in XenServer 5.0. /// Deprecated since XenServer 5.6. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 5.6")] public static void wait_memory_target_live(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_wait_memory_target_live(session.opaque_ref, _vm); else session.proxy.vm_wait_memory_target_live(session.opaque_ref, _vm ?? "").parse(); } /// /// Wait for a running VM to reach its current memory target /// First published in XenServer 5.0. /// Deprecated since XenServer 5.6. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 5.6")] public static XenRef async_wait_memory_target_live(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_wait_memory_target_live(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_wait_memory_target_live(session.opaque_ref, _vm ?? "").parse()); } /// /// Return true if the VM is currently 'co-operative' i.e. is expected to reach a balloon target and actually has done /// First published in XenServer 5.6. /// Deprecated since XenServer 6.1. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.1")] public static bool get_cooperative(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_cooperative(session.opaque_ref, _vm); else return (bool)session.proxy.vm_get_cooperative(session.opaque_ref, _vm ?? "").parse(); } /// /// Return true if the VM is currently 'co-operative' i.e. is expected to reach a balloon target and actually has done /// First published in XenServer 5.6. /// Deprecated since XenServer 6.1. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 6.1")] public static XenRef async_get_cooperative(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_get_cooperative(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_get_cooperative(session.opaque_ref, _vm ?? "").parse()); } /// /// Set the shadow memory multiplier on a halted VM /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new shadow memory multiplier to set public static void set_HVM_shadow_multiplier(Session session, string _vm, double _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_hvm_shadow_multiplier(session.opaque_ref, _vm, _value); else session.proxy.vm_set_hvm_shadow_multiplier(session.opaque_ref, _vm ?? "", _value).parse(); } /// /// Set the shadow memory multiplier on a running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The new shadow memory multiplier to set public static void set_shadow_multiplier_live(Session session, string _vm, double _multiplier) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_shadow_multiplier_live(session.opaque_ref, _vm, _multiplier); else session.proxy.vm_set_shadow_multiplier_live(session.opaque_ref, _vm ?? "", _multiplier).parse(); } /// /// Set the shadow memory multiplier on a running VM /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The new shadow memory multiplier to set public static XenRef async_set_shadow_multiplier_live(Session session, string _vm, double _multiplier) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_shadow_multiplier_live(session.opaque_ref, _vm, _multiplier); else return XenRef.Create(session.proxy.async_vm_set_shadow_multiplier_live(session.opaque_ref, _vm ?? "", _multiplier).parse()); } /// /// Set the maximum number of VCPUs for a halted VM /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new maximum number of VCPUs public static void set_VCPUs_max(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_vcpus_max(session.opaque_ref, _vm, _value); else session.proxy.vm_set_vcpus_max(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set the number of startup VCPUs for a halted VM /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The new maximum number of VCPUs public static void set_VCPUs_at_startup(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_vcpus_at_startup(session.opaque_ref, _vm, _value); else session.proxy.vm_set_vcpus_at_startup(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Send the given key as a sysrq to this VM. The key is specified as a single character (a String of length 1). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The key to send public static void send_sysrq(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_send_sysrq(session.opaque_ref, _vm, _key); else session.proxy.vm_send_sysrq(session.opaque_ref, _vm ?? "", _key ?? "").parse(); } /// /// Send the given key as a sysrq to this VM. The key is specified as a single character (a String of length 1). This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The key to send public static XenRef async_send_sysrq(Session session, string _vm, string _key) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_send_sysrq(session.opaque_ref, _vm, _key); else return XenRef.Create(session.proxy.async_vm_send_sysrq(session.opaque_ref, _vm ?? "", _key ?? "").parse()); } /// /// Send the named trigger to this VM. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The trigger to send public static void send_trigger(Session session, string _vm, string _trigger) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_send_trigger(session.opaque_ref, _vm, _trigger); else session.proxy.vm_send_trigger(session.opaque_ref, _vm ?? "", _trigger ?? "").parse(); } /// /// Send the named trigger to this VM. This can only be called when the specified VM is in the Running state. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The trigger to send public static XenRef async_send_trigger(Session session, string _vm, string _trigger) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_send_trigger(session.opaque_ref, _vm, _trigger); else return XenRef.Create(session.proxy.async_vm_send_trigger(session.opaque_ref, _vm ?? "", _trigger ?? "").parse()); } /// /// Returns the maximum amount of guest memory which will fit, together with overheads, in the supplied amount of physical memory. If 'exact' is true then an exact calculation is performed using the VM's current settings. If 'exact' is false then a more conservative approximation is used /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm /// Total amount of physical RAM to fit within /// If false the limit is calculated with the guest's current exact configuration. Otherwise a more approximate calculation is performed public static long maximise_memory(Session session, string _vm, long _total, bool _approximate) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_maximise_memory(session.opaque_ref, _vm, _total, _approximate); else return long.Parse(session.proxy.vm_maximise_memory(session.opaque_ref, _vm ?? "", _total.ToString(), _approximate).parse()); } /// /// Returns the maximum amount of guest memory which will fit, together with overheads, in the supplied amount of physical memory. If 'exact' is true then an exact calculation is performed using the VM's current settings. If 'exact' is false then a more conservative approximation is used /// First published in XenServer 4.1. /// /// The session /// The opaque_ref of the given vm /// Total amount of physical RAM to fit within /// If false the limit is calculated with the guest's current exact configuration. Otherwise a more approximate calculation is performed public static XenRef async_maximise_memory(Session session, string _vm, long _total, bool _approximate) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_maximise_memory(session.opaque_ref, _vm, _total, _approximate); else return XenRef.Create(session.proxy.async_vm_maximise_memory(session.opaque_ref, _vm ?? "", _total.ToString(), _approximate).parse()); } /// /// Migrate the VM to another host. This can only be called when the specified VM is in the Running state. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a Host.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters public static XenRef migrate_send(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_migrate_send(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options); else return XenRef.Create(session.proxy.vm_migrate_send(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options)).parse()); } /// /// Migrate the VM to another host. This can only be called when the specified VM is in the Running state. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a Host.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters public static XenRef async_migrate_send(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_migrate_send(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options); else return XenRef.Create(session.proxy.async_vm_migrate_send(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options)).parse()); } /// /// Migrate the VM to another host. This can only be called when the specified VM is in the Running state. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a Host.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters /// Map of source vGPU to destination GPU group First published in XenServer 7.3. public static XenRef migrate_send(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options, Dictionary, XenRef> _vgpu_map) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_migrate_send(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options, _vgpu_map); else return XenRef.Create(session.proxy.vm_migrate_send(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options), Maps.convert_to_proxy_XenRefVGPU_XenRefGPU_group(_vgpu_map)).parse()); } /// /// Migrate the VM to another host. This can only be called when the specified VM is in the Running state. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a Host.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters /// Map of source vGPU to destination GPU group First published in XenServer 7.3. public static XenRef async_migrate_send(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options, Dictionary, XenRef> _vgpu_map) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_migrate_send(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options, _vgpu_map); else return XenRef.Create(session.proxy.async_vm_migrate_send(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options), Maps.convert_to_proxy_XenRefVGPU_XenRefGPU_group(_vgpu_map)).parse()); } /// /// Assert whether a VM can be migrated to the specified destination. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a VM.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters public static void assert_can_migrate(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_can_migrate(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options); else session.proxy.vm_assert_can_migrate(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options)).parse(); } /// /// Assert whether a VM can be migrated to the specified destination. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a VM.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters public static XenRef async_assert_can_migrate(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_can_migrate(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options); else return XenRef.Create(session.proxy.async_vm_assert_can_migrate(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options)).parse()); } /// /// Assert whether a VM can be migrated to the specified destination. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a VM.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters /// Map of source vGPU to destination GPU group First published in XenServer 7.3. public static void assert_can_migrate(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options, Dictionary, XenRef> _vgpu_map) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_can_migrate(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options, _vgpu_map); else session.proxy.vm_assert_can_migrate(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options), Maps.convert_to_proxy_XenRefVGPU_XenRefGPU_group(_vgpu_map)).parse(); } /// /// Assert whether a VM can be migrated to the specified destination. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm /// The result of a VM.migrate_receive call. /// Live migration /// Map of source VDI to destination SR /// Map of source VIF to destination network /// Other parameters /// Map of source vGPU to destination GPU group First published in XenServer 7.3. public static XenRef async_assert_can_migrate(Session session, string _vm, Dictionary _dest, bool _live, Dictionary, XenRef> _vdi_map, Dictionary, XenRef> _vif_map, Dictionary _options, Dictionary, XenRef> _vgpu_map) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_can_migrate(session.opaque_ref, _vm, _dest, _live, _vdi_map, _vif_map, _options, _vgpu_map); else return XenRef.Create(session.proxy.async_vm_assert_can_migrate(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_dest), _live, Maps.convert_to_proxy_XenRefVDI_XenRefSR(_vdi_map), Maps.convert_to_proxy_XenRefVIF_XenRefNetwork(_vif_map), Maps.convert_to_proxy_string_string(_options), Maps.convert_to_proxy_XenRefVGPU_XenRefGPU_group(_vgpu_map)).parse()); } /// /// Returns a record describing the VM's dynamic state, initialised when the VM boots and updated to reflect runtime configuration changes e.g. CPU hotplug /// First published in XenServer 4.0. /// Deprecated since XenServer 7.3. /// /// The session /// The opaque_ref of the given vm [Deprecated("XenServer 7.3")] public static VM get_boot_record(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_boot_record(session.opaque_ref, _vm); else return new VM(session.proxy.vm_get_boot_record(session.opaque_ref, _vm ?? "").parse()); } /// /// /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static List get_data_sources(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_data_sources(session.opaque_ref, _vm); else return Data_source.ProxyArrayToObjectList(session.proxy.vm_get_data_sources(session.opaque_ref, _vm ?? "").parse()); } /// /// Start recording the specified data source /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The data source to record public static void record_data_source(Session session, string _vm, string _data_source) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_record_data_source(session.opaque_ref, _vm, _data_source); else session.proxy.vm_record_data_source(session.opaque_ref, _vm ?? "", _data_source ?? "").parse(); } /// /// Query the latest value of the specified data source /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The data source to query public static double query_data_source(Session session, string _vm, string _data_source) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_query_data_source(session.opaque_ref, _vm, _data_source); else return Convert.ToDouble(session.proxy.vm_query_data_source(session.opaque_ref, _vm ?? "", _data_source ?? "").parse()); } /// /// Forget the recorded statistics related to the specified data source /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The data source whose archives are to be forgotten public static void forget_data_source_archives(Session session, string _vm, string _data_source) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_forget_data_source_archives(session.opaque_ref, _vm, _data_source); else session.proxy.vm_forget_data_source_archives(session.opaque_ref, _vm ?? "", _data_source ?? "").parse(); } /// /// Check to see whether this operation is acceptable in the current state of the system, raising an error if the operation is invalid for some reason /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// proposed operation public static void assert_operation_valid(Session session, string _vm, vm_operations _op) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_operation_valid(session.opaque_ref, _vm, _op); else session.proxy.vm_assert_operation_valid(session.opaque_ref, _vm ?? "", vm_operations_helper.ToString(_op)).parse(); } /// /// Check to see whether this operation is acceptable in the current state of the system, raising an error if the operation is invalid for some reason /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// proposed operation public static XenRef async_assert_operation_valid(Session session, string _vm, vm_operations _op) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_operation_valid(session.opaque_ref, _vm, _op); else return XenRef.Create(session.proxy.async_vm_assert_operation_valid(session.opaque_ref, _vm ?? "", vm_operations_helper.ToString(_op)).parse()); } /// /// Recomputes the list of acceptable operations /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static void update_allowed_operations(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_update_allowed_operations(session.opaque_ref, _vm); else session.proxy.vm_update_allowed_operations(session.opaque_ref, _vm ?? "").parse(); } /// /// Recomputes the list of acceptable operations /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_update_allowed_operations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_update_allowed_operations(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_update_allowed_operations(session.opaque_ref, _vm ?? "").parse()); } /// /// Returns a list of the allowed values that a VBD device field can take /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string[] get_allowed_VBD_devices(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_allowed_vbd_devices(session.opaque_ref, _vm); else return (string [])session.proxy.vm_get_allowed_vbd_devices(session.opaque_ref, _vm ?? "").parse(); } /// /// Returns a list of the allowed values that a VIF device field can take /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static string[] get_allowed_VIF_devices(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_allowed_vif_devices(session.opaque_ref, _vm); else return (string [])session.proxy.vm_get_allowed_vif_devices(session.opaque_ref, _vm ?? "").parse(); } /// /// Return the list of hosts on which this VM may run. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static List> get_possible_hosts(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_possible_hosts(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.vm_get_possible_hosts(session.opaque_ref, _vm ?? "").parse()); } /// /// Return the list of hosts on which this VM may run. /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_get_possible_hosts(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_get_possible_hosts(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_get_possible_hosts(session.opaque_ref, _vm ?? "").parse()); } /// /// Returns an error if the VM could not boot on this host for some reason /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The host public static void assert_can_boot_here(Session session, string _vm, string _host) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_can_boot_here(session.opaque_ref, _vm, _host); else session.proxy.vm_assert_can_boot_here(session.opaque_ref, _vm ?? "", _host ?? "").parse(); } /// /// Returns an error if the VM could not boot on this host for some reason /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The host public static XenRef async_assert_can_boot_here(Session session, string _vm, string _host) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_can_boot_here(session.opaque_ref, _vm, _host); else return XenRef.Create(session.proxy.async_vm_assert_can_boot_here(session.opaque_ref, _vm ?? "", _host ?? "").parse()); } /// /// Create a placeholder for a named binary blob of data that is associated with this VM /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name associated with the blob /// The mime type for the data. Empty string translates to application/octet-stream public static XenRef create_new_blob(Session session, string _vm, string _name, string _mime_type) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_create_new_blob(session.opaque_ref, _vm, _name, _mime_type); else return XenRef.Create(session.proxy.vm_create_new_blob(session.opaque_ref, _vm ?? "", _name ?? "", _mime_type ?? "").parse()); } /// /// Create a placeholder for a named binary blob of data that is associated with this VM /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name associated with the blob /// The mime type for the data. Empty string translates to application/octet-stream public static XenRef async_create_new_blob(Session session, string _vm, string _name, string _mime_type) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_create_new_blob(session.opaque_ref, _vm, _name, _mime_type); else return XenRef.Create(session.proxy.async_vm_create_new_blob(session.opaque_ref, _vm ?? "", _name ?? "", _mime_type ?? "").parse()); } /// /// Create a placeholder for a named binary blob of data that is associated with this VM /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name associated with the blob /// The mime type for the data. Empty string translates to application/octet-stream /// True if the blob should be publicly available First published in XenServer 6.1. public static XenRef create_new_blob(Session session, string _vm, string _name, string _mime_type, bool _public) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_create_new_blob(session.opaque_ref, _vm, _name, _mime_type, _public); else return XenRef.Create(session.proxy.vm_create_new_blob(session.opaque_ref, _vm ?? "", _name ?? "", _mime_type ?? "", _public).parse()); } /// /// Create a placeholder for a named binary blob of data that is associated with this VM /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The name associated with the blob /// The mime type for the data. Empty string translates to application/octet-stream /// True if the blob should be publicly available First published in XenServer 6.1. public static XenRef async_create_new_blob(Session session, string _vm, string _name, string _mime_type, bool _public) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_create_new_blob(session.opaque_ref, _vm, _name, _mime_type, _public); else return XenRef.Create(session.proxy.async_vm_create_new_blob(session.opaque_ref, _vm ?? "", _name ?? "", _mime_type ?? "", _public).parse()); } /// /// Returns an error if the VM is not considered agile e.g. because it is tied to a resource local to a host /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static void assert_agile(Session session, string _vm) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_agile(session.opaque_ref, _vm); else session.proxy.vm_assert_agile(session.opaque_ref, _vm ?? "").parse(); } /// /// Returns an error if the VM is not considered agile e.g. because it is tied to a resource local to a host /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm public static XenRef async_assert_agile(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_agile(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_assert_agile(session.opaque_ref, _vm ?? "").parse()); } /// /// Returns mapping of hosts to ratings, indicating the suitability of starting the VM at that location according to wlb. Rating is replaced with an error if the VM cannot boot there. /// First published in XenServer 5.5. /// /// The session /// The opaque_ref of the given vm public static Dictionary, string[]> retrieve_wlb_recommendations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_retrieve_wlb_recommendations(session.opaque_ref, _vm); else return Maps.convert_from_proxy_XenRefHost_string_array(session.proxy.vm_retrieve_wlb_recommendations(session.opaque_ref, _vm ?? "").parse()); } /// /// Returns mapping of hosts to ratings, indicating the suitability of starting the VM at that location according to wlb. Rating is replaced with an error if the VM cannot boot there. /// First published in XenServer 5.5. /// /// The session /// The opaque_ref of the given vm public static XenRef async_retrieve_wlb_recommendations(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_retrieve_wlb_recommendations(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_retrieve_wlb_recommendations(session.opaque_ref, _vm ?? "").parse()); } /// /// Set custom BIOS strings to this VM. VM will be given a default set of BIOS strings, only some of which can be overridden by the supplied values. Allowed keys are: 'bios-vendor', 'bios-version', 'system-manufacturer', 'system-product-name', 'system-version', 'system-serial-number', 'enclosure-asset-tag', 'baseboard-manufacturer', 'baseboard-product-name', 'baseboard-version', 'baseboard-serial-number', 'baseboard-asset-tag', 'baseboard-location-in-chassis', 'enclosure-asset-tag' /// First published in XenServer 7.3. /// /// The session /// The opaque_ref of the given vm /// The custom BIOS strings as a list of key-value pairs public static void set_bios_strings(Session session, string _vm, Dictionary _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_bios_strings(session.opaque_ref, _vm, _value); else session.proxy.vm_set_bios_strings(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_value)).parse(); } /// /// Set custom BIOS strings to this VM. VM will be given a default set of BIOS strings, only some of which can be overridden by the supplied values. Allowed keys are: 'bios-vendor', 'bios-version', 'system-manufacturer', 'system-product-name', 'system-version', 'system-serial-number', 'enclosure-asset-tag', 'baseboard-manufacturer', 'baseboard-product-name', 'baseboard-version', 'baseboard-serial-number', 'baseboard-asset-tag', 'baseboard-location-in-chassis', 'enclosure-asset-tag' /// First published in XenServer 7.3. /// /// The session /// The opaque_ref of the given vm /// The custom BIOS strings as a list of key-value pairs public static XenRef async_set_bios_strings(Session session, string _vm, Dictionary _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_bios_strings(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_bios_strings(session.opaque_ref, _vm ?? "", Maps.convert_to_proxy_string_string(_value)).parse()); } /// /// Copy the BIOS strings from the given host to this VM /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The host to copy the BIOS strings from public static void copy_bios_strings(Session session, string _vm, string _host) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_copy_bios_strings(session.opaque_ref, _vm, _host); else session.proxy.vm_copy_bios_strings(session.opaque_ref, _vm ?? "", _host ?? "").parse(); } /// /// Copy the BIOS strings from the given host to this VM /// First published in XenServer 5.6. /// /// The session /// The opaque_ref of the given vm /// The host to copy the BIOS strings from public static XenRef async_copy_bios_strings(Session session, string _vm, string _host) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_copy_bios_strings(session.opaque_ref, _vm, _host); else return XenRef.Create(session.proxy.async_vm_copy_bios_strings(session.opaque_ref, _vm ?? "", _host ?? "").parse()); } /// /// Set the value of the protection_policy field /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given vm /// The value public static void set_protection_policy(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_protection_policy(session.opaque_ref, _vm, _value); else session.proxy.vm_set_protection_policy(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Set the value of the snapshot schedule field /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vm /// The value public static void set_snapshot_schedule(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_snapshot_schedule(session.opaque_ref, _vm, _value); else session.proxy.vm_set_snapshot_schedule(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Set this VM's start delay in seconds /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's start delay in seconds public static void set_start_delay(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_start_delay(session.opaque_ref, _vm, _value); else session.proxy.vm_set_start_delay(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set this VM's start delay in seconds /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's start delay in seconds public static XenRef async_set_start_delay(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_start_delay(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_start_delay(session.opaque_ref, _vm ?? "", _value.ToString()).parse()); } /// /// Set this VM's shutdown delay in seconds /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's shutdown delay in seconds public static void set_shutdown_delay(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_shutdown_delay(session.opaque_ref, _vm, _value); else session.proxy.vm_set_shutdown_delay(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set this VM's shutdown delay in seconds /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's shutdown delay in seconds public static XenRef async_set_shutdown_delay(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_shutdown_delay(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_shutdown_delay(session.opaque_ref, _vm ?? "", _value.ToString()).parse()); } /// /// Set this VM's boot order /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's boot order public static void set_order(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_order(session.opaque_ref, _vm, _value); else session.proxy.vm_set_order(session.opaque_ref, _vm ?? "", _value.ToString()).parse(); } /// /// Set this VM's boot order /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// This VM's boot order public static XenRef async_set_order(Session session, string _vm, long _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_order(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_order(session.opaque_ref, _vm ?? "", _value.ToString()).parse()); } /// /// Set this VM's suspend VDI, which must be indentical to its current one /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The suspend VDI uuid public static void set_suspend_VDI(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_suspend_vdi(session.opaque_ref, _vm, _value); else session.proxy.vm_set_suspend_vdi(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Set this VM's suspend VDI, which must be indentical to its current one /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The suspend VDI uuid public static XenRef async_set_suspend_VDI(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_suspend_vdi(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_suspend_vdi(session.opaque_ref, _vm ?? "", _value ?? "").parse()); } /// /// Assert whether all SRs required to recover this VM are available. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The session to which the VM is to be recovered. public static void assert_can_be_recovered(Session session, string _vm, string _session_to) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_assert_can_be_recovered(session.opaque_ref, _vm, _session_to); else session.proxy.vm_assert_can_be_recovered(session.opaque_ref, _vm ?? "", _session_to ?? "").parse(); } /// /// Assert whether all SRs required to recover this VM are available. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The session to which the VM is to be recovered. public static XenRef async_assert_can_be_recovered(Session session, string _vm, string _session_to) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_assert_can_be_recovered(session.opaque_ref, _vm, _session_to); else return XenRef.Create(session.proxy.async_vm_assert_can_be_recovered(session.opaque_ref, _vm ?? "", _session_to ?? "").parse()); } /// /// List all the SR's that are required for the VM to be recovered /// First published in XenServer 6.5. /// /// The session /// The opaque_ref of the given vm /// The session to which the SRs of the VM have to be recovered. public static List> get_SRs_required_for_recovery(Session session, string _vm, string _session_to) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_srs_required_for_recovery(session.opaque_ref, _vm, _session_to); else return XenRef.Create(session.proxy.vm_get_srs_required_for_recovery(session.opaque_ref, _vm ?? "", _session_to ?? "").parse()); } /// /// List all the SR's that are required for the VM to be recovered /// First published in XenServer 6.5. /// /// The session /// The opaque_ref of the given vm /// The session to which the SRs of the VM have to be recovered. public static XenRef async_get_SRs_required_for_recovery(Session session, string _vm, string _session_to) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_get_srs_required_for_recovery(session.opaque_ref, _vm, _session_to); else return XenRef.Create(session.proxy.async_vm_get_srs_required_for_recovery(session.opaque_ref, _vm ?? "", _session_to ?? "").parse()); } /// /// Recover the VM /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The session to which the VM is to be recovered. /// Whether the VM should replace newer versions of itself. public static void recover(Session session, string _vm, string _session_to, bool _force) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_recover(session.opaque_ref, _vm, _session_to, _force); else session.proxy.vm_recover(session.opaque_ref, _vm ?? "", _session_to ?? "", _force).parse(); } /// /// Recover the VM /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The session to which the VM is to be recovered. /// Whether the VM should replace newer versions of itself. public static XenRef async_recover(Session session, string _vm, string _session_to, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_recover(session.opaque_ref, _vm, _session_to, _force); else return XenRef.Create(session.proxy.async_vm_recover(session.opaque_ref, _vm ?? "", _session_to ?? "", _force).parse()); } /// /// Import using a conversion service. /// First published in XenServer 6.1. /// /// The session /// Type of the conversion /// Admin username on the host /// Password on the host /// The destination SR /// Remote configuration options public static void import_convert(Session session, string _type, string _username, string _password, string _sr, Dictionary _remote_config) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_import_convert(session.opaque_ref, _type, _username, _password, _sr, _remote_config); else session.proxy.vm_import_convert(session.opaque_ref, _type ?? "", _username ?? "", _password ?? "", _sr ?? "", Maps.convert_to_proxy_string_string(_remote_config)).parse(); } /// /// Import using a conversion service. /// First published in XenServer 6.1. /// /// The session /// Type of the conversion /// Admin username on the host /// Password on the host /// The destination SR /// Remote configuration options public static XenRef async_import_convert(Session session, string _type, string _username, string _password, string _sr, Dictionary _remote_config) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_import_convert(session.opaque_ref, _type, _username, _password, _sr, _remote_config); else return XenRef.Create(session.proxy.async_vm_import_convert(session.opaque_ref, _type ?? "", _username ?? "", _password ?? "", _sr ?? "", Maps.convert_to_proxy_string_string(_remote_config)).parse()); } /// /// Assign this VM to an appliance. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The appliance to which this VM should be assigned. public static void set_appliance(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_appliance(session.opaque_ref, _vm, _value); else session.proxy.vm_set_appliance(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Assign this VM to an appliance. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given vm /// The appliance to which this VM should be assigned. public static XenRef async_set_appliance(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_appliance(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_appliance(session.opaque_ref, _vm ?? "", _value ?? "").parse()); } /// /// Query the system services advertised by this VM and register them. This can only be applied to a system domain. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm public static Dictionary query_services(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_query_services(session.opaque_ref, _vm); else return Maps.convert_from_proxy_string_string(session.proxy.vm_query_services(session.opaque_ref, _vm ?? "").parse()); } /// /// Query the system services advertised by this VM and register them. This can only be applied to a system domain. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given vm public static XenRef async_query_services(Session session, string _vm) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_query_services(session.opaque_ref, _vm); else return XenRef.Create(session.proxy.async_vm_query_services(session.opaque_ref, _vm ?? "").parse()); } /// /// Call an API plugin on this vm /// First published in XenServer 6.5 SP1. /// /// The session /// The opaque_ref of the given vm /// The name of the plugin /// The name of the function within the plugin /// Arguments for the function public static string call_plugin(Session session, string _vm, string _plugin, string _fn, Dictionary _args) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_call_plugin(session.opaque_ref, _vm, _plugin, _fn, _args); else return session.proxy.vm_call_plugin(session.opaque_ref, _vm ?? "", _plugin ?? "", _fn ?? "", Maps.convert_to_proxy_string_string(_args)).parse(); } /// /// Call an API plugin on this vm /// First published in XenServer 6.5 SP1. /// /// The session /// The opaque_ref of the given vm /// The name of the plugin /// The name of the function within the plugin /// Arguments for the function public static XenRef async_call_plugin(Session session, string _vm, string _plugin, string _fn, Dictionary _args) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_call_plugin(session.opaque_ref, _vm, _plugin, _fn, _args); else return XenRef.Create(session.proxy.async_vm_call_plugin(session.opaque_ref, _vm ?? "", _plugin ?? "", _fn ?? "", Maps.convert_to_proxy_string_string(_args)).parse()); } /// /// Controls whether, when the VM starts in HVM mode, its virtual hardware will include the emulated PCI device for which drivers may be available through Windows Update. Usually this should never be changed on a VM on which Windows has been installed: changing it on such a VM is likely to lead to a crash on next start. /// First published in XenServer 7.0. /// /// The session /// The opaque_ref of the given vm /// True to provide the vendor PCI device. public static void set_has_vendor_device(Session session, string _vm, bool _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_has_vendor_device(session.opaque_ref, _vm, _value); else session.proxy.vm_set_has_vendor_device(session.opaque_ref, _vm ?? "", _value).parse(); } /// /// Controls whether, when the VM starts in HVM mode, its virtual hardware will include the emulated PCI device for which drivers may be available through Windows Update. Usually this should never be changed on a VM on which Windows has been installed: changing it on such a VM is likely to lead to a crash on next start. /// First published in XenServer 7.0. /// /// The session /// The opaque_ref of the given vm /// True to provide the vendor PCI device. public static XenRef async_set_has_vendor_device(Session session, string _vm, bool _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_has_vendor_device(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_has_vendor_device(session.opaque_ref, _vm ?? "", _value).parse()); } /// /// Import an XVA from a URI /// First published in XenServer 7.0. /// /// The session /// The URL of the XVA file /// The destination SR for the disks /// Perform a full restore /// Force the import public static List> import(Session session, string _url, string _sr, bool _full_restore, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_import(session.opaque_ref, _url, _sr, _full_restore, _force); else return XenRef.Create(session.proxy.vm_import(session.opaque_ref, _url ?? "", _sr ?? "", _full_restore, _force).parse()); } /// /// Import an XVA from a URI /// First published in XenServer 7.0. /// /// The session /// The URL of the XVA file /// The destination SR for the disks /// Perform a full restore /// Force the import public static XenRef async_import(Session session, string _url, string _sr, bool _full_restore, bool _force) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_import(session.opaque_ref, _url, _sr, _full_restore, _force); else return XenRef.Create(session.proxy.async_vm_import(session.opaque_ref, _url ?? "", _sr ?? "", _full_restore, _force).parse()); } /// /// Sets the actions_after_crash parameter /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The new value to set public static void set_actions_after_crash(Session session, string _vm, on_crash_behaviour _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_actions_after_crash(session.opaque_ref, _vm, _value); else session.proxy.vm_set_actions_after_crash(session.opaque_ref, _vm ?? "", on_crash_behaviour_helper.ToString(_value)).parse(); } /// /// Sets the actions_after_crash parameter /// First published in XenServer 4.0. /// /// The session /// The opaque_ref of the given vm /// The new value to set public static XenRef async_set_actions_after_crash(Session session, string _vm, on_crash_behaviour _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vm_set_actions_after_crash(session.opaque_ref, _vm, _value); else return XenRef.Create(session.proxy.async_vm_set_actions_after_crash(session.opaque_ref, _vm ?? "", on_crash_behaviour_helper.ToString(_value)).parse()); } /// /// Set the VM.domain_type field of the given VM, which will take effect when it is next started /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given vm /// The new domain type public static void set_domain_type(Session session, string _vm, domain_type _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_domain_type(session.opaque_ref, _vm, _value); else session.proxy.vm_set_domain_type(session.opaque_ref, _vm ?? "", domain_type_helper.ToString(_value)).parse(); } /// /// Set the VM.HVM_boot_policy field of the given VM, which will take effect when it is next started /// First published in XenServer 4.0. /// Deprecated since XenServer 7.5. /// /// The session /// The opaque_ref of the given vm /// The new HVM boot policy [Deprecated("XenServer 7.5")] public static void set_HVM_boot_policy(Session session, string _vm, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vm_set_hvm_boot_policy(session.opaque_ref, _vm, _value); else session.proxy.vm_set_hvm_boot_policy(session.opaque_ref, _vm ?? "", _value ?? "").parse(); } /// /// Return a list of all the VMs known to the system. /// First published in XenServer 4.0. /// /// The session public static List> get_all(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_all(session.opaque_ref); else return XenRef.Create(session.proxy.vm_get_all(session.opaque_ref).parse()); } /// /// Get all the VM Records at once, in a single XML RPC call /// First published in XenServer 4.0. /// /// The session public static Dictionary, VM> get_all_records(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vm_get_all_records(session.opaque_ref); else return XenRef.Create(session.proxy.vm_get_all_records(session.opaque_ref).parse()); } /// /// Unique identifier/object reference /// public virtual string uuid { get { return _uuid; } set { if (!Helper.AreEqual(value, _uuid)) { _uuid = value; Changed = true; NotifyPropertyChanged("uuid"); } } } private string _uuid = ""; /// /// 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. /// public virtual List allowed_operations { get { return _allowed_operations; } set { if (!Helper.AreEqual(value, _allowed_operations)) { _allowed_operations = value; Changed = true; NotifyPropertyChanged("allowed_operations"); } } } private List _allowed_operations = new List() {}; /// /// links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task. /// public virtual Dictionary current_operations { get { return _current_operations; } set { if (!Helper.AreEqual(value, _current_operations)) { _current_operations = value; Changed = true; NotifyPropertyChanged("current_operations"); } } } private Dictionary _current_operations = new Dictionary() {}; /// /// Current power state of the machine /// [JsonConverter(typeof(vm_power_stateConverter))] public virtual vm_power_state power_state { get { return _power_state; } set { if (!Helper.AreEqual(value, _power_state)) { _power_state = value; Changed = true; NotifyPropertyChanged("power_state"); } } } private vm_power_state _power_state; /// /// a human-readable name /// public virtual string name_label { get { return _name_label; } set { if (!Helper.AreEqual(value, _name_label)) { _name_label = value; Changed = true; NotifyPropertyChanged("name_label"); } } } private string _name_label = ""; /// /// a notes field containing human-readable description /// public virtual string name_description { get { return _name_description; } set { if (!Helper.AreEqual(value, _name_description)) { _name_description = value; Changed = true; NotifyPropertyChanged("name_description"); } } } private string _name_description = ""; /// /// Creators of VMs and templates may store version information here. /// public virtual long user_version { get { return _user_version; } set { if (!Helper.AreEqual(value, _user_version)) { _user_version = value; Changed = true; NotifyPropertyChanged("user_version"); } } } private long _user_version; /// /// true if this is a template. Template VMs can never be started, they are used only for cloning other VMs /// public virtual bool is_a_template { get { return _is_a_template; } set { if (!Helper.AreEqual(value, _is_a_template)) { _is_a_template = value; Changed = true; NotifyPropertyChanged("is_a_template"); } } } private bool _is_a_template; /// /// true if this is a default template. Default template VMs can never be started or migrated, they are used only for cloning other VMs /// First published in XenServer 7.2. /// public virtual bool is_default_template { get { return _is_default_template; } set { if (!Helper.AreEqual(value, _is_default_template)) { _is_default_template = value; Changed = true; NotifyPropertyChanged("is_default_template"); } } } private bool _is_default_template = false; /// /// The VDI that a suspend image is stored on. (Only has meaning if VM is currently suspended) /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef suspend_VDI { get { return _suspend_VDI; } set { if (!Helper.AreEqual(value, _suspend_VDI)) { _suspend_VDI = value; Changed = true; NotifyPropertyChanged("suspend_VDI"); } } } private XenRef _suspend_VDI = new XenRef(Helper.NullOpaqueRef); /// /// the host the VM is currently resident on /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef resident_on { get { return _resident_on; } set { if (!Helper.AreEqual(value, _resident_on)) { _resident_on = value; Changed = true; NotifyPropertyChanged("resident_on"); } } } private XenRef _resident_on = new XenRef(Helper.NullOpaqueRef); /// /// A host which the VM has some affinity for (or NULL). This is used as a hint to the start call when it decides where to run the VM. Resource constraints may cause the VM to be started elsewhere. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef affinity { get { return _affinity; } set { if (!Helper.AreEqual(value, _affinity)) { _affinity = value; Changed = true; NotifyPropertyChanged("affinity"); } } } private XenRef _affinity = new XenRef(Helper.NullOpaqueRef); /// /// Virtualization memory overhead (bytes). /// public virtual long memory_overhead { get { return _memory_overhead; } set { if (!Helper.AreEqual(value, _memory_overhead)) { _memory_overhead = value; Changed = true; NotifyPropertyChanged("memory_overhead"); } } } private long _memory_overhead = 0; /// /// Dynamically-set memory target (bytes). The value of this field indicates the current target for memory available to this VM. /// public virtual long memory_target { get { return _memory_target; } set { if (!Helper.AreEqual(value, _memory_target)) { _memory_target = value; Changed = true; NotifyPropertyChanged("memory_target"); } } } private long _memory_target = 0; /// /// Statically-set (i.e. absolute) maximum (bytes). The value of this field at VM start time acts as a hard limit of the amount of memory a guest can use. New values only take effect on reboot. /// public virtual long memory_static_max { get { return _memory_static_max; } set { if (!Helper.AreEqual(value, _memory_static_max)) { _memory_static_max = value; Changed = true; NotifyPropertyChanged("memory_static_max"); } } } private long _memory_static_max; /// /// Dynamic maximum (bytes) /// public virtual long memory_dynamic_max { get { return _memory_dynamic_max; } set { if (!Helper.AreEqual(value, _memory_dynamic_max)) { _memory_dynamic_max = value; Changed = true; NotifyPropertyChanged("memory_dynamic_max"); } } } private long _memory_dynamic_max; /// /// Dynamic minimum (bytes) /// public virtual long memory_dynamic_min { get { return _memory_dynamic_min; } set { if (!Helper.AreEqual(value, _memory_dynamic_min)) { _memory_dynamic_min = value; Changed = true; NotifyPropertyChanged("memory_dynamic_min"); } } } private long _memory_dynamic_min; /// /// Statically-set (i.e. absolute) mininum (bytes). The value of this field indicates the least amount of memory this VM can boot with without crashing. /// public virtual long memory_static_min { get { return _memory_static_min; } set { if (!Helper.AreEqual(value, _memory_static_min)) { _memory_static_min = value; Changed = true; NotifyPropertyChanged("memory_static_min"); } } } private long _memory_static_min; /// /// configuration parameters for the selected VCPU policy /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary VCPUs_params { get { return _VCPUs_params; } set { if (!Helper.AreEqual(value, _VCPUs_params)) { _VCPUs_params = value; Changed = true; NotifyPropertyChanged("VCPUs_params"); } } } private Dictionary _VCPUs_params = new Dictionary() {}; /// /// Max number of VCPUs /// public virtual long VCPUs_max { get { return _VCPUs_max; } set { if (!Helper.AreEqual(value, _VCPUs_max)) { _VCPUs_max = value; Changed = true; NotifyPropertyChanged("VCPUs_max"); } } } private long _VCPUs_max; /// /// Boot number of VCPUs /// public virtual long VCPUs_at_startup { get { return _VCPUs_at_startup; } set { if (!Helper.AreEqual(value, _VCPUs_at_startup)) { _VCPUs_at_startup = value; Changed = true; NotifyPropertyChanged("VCPUs_at_startup"); } } } private long _VCPUs_at_startup; /// /// action to take after the guest has shutdown itself /// [JsonConverter(typeof(on_normal_exitConverter))] public virtual on_normal_exit actions_after_shutdown { get { return _actions_after_shutdown; } set { if (!Helper.AreEqual(value, _actions_after_shutdown)) { _actions_after_shutdown = value; Changed = true; NotifyPropertyChanged("actions_after_shutdown"); } } } private on_normal_exit _actions_after_shutdown; /// /// action to take after the guest has rebooted itself /// [JsonConverter(typeof(on_normal_exitConverter))] public virtual on_normal_exit actions_after_reboot { get { return _actions_after_reboot; } set { if (!Helper.AreEqual(value, _actions_after_reboot)) { _actions_after_reboot = value; Changed = true; NotifyPropertyChanged("actions_after_reboot"); } } } private on_normal_exit _actions_after_reboot; /// /// action to take if the guest crashes /// [JsonConverter(typeof(on_crash_behaviourConverter))] public virtual on_crash_behaviour actions_after_crash { get { return _actions_after_crash; } set { if (!Helper.AreEqual(value, _actions_after_crash)) { _actions_after_crash = value; Changed = true; NotifyPropertyChanged("actions_after_crash"); } } } private on_crash_behaviour _actions_after_crash; /// /// virtual console devices /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> consoles { get { return _consoles; } set { if (!Helper.AreEqual(value, _consoles)) { _consoles = value; Changed = true; NotifyPropertyChanged("consoles"); } } } private List> _consoles = new List>() {}; /// /// virtual network interfaces /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VIFs { get { return _VIFs; } set { if (!Helper.AreEqual(value, _VIFs)) { _VIFs = value; Changed = true; NotifyPropertyChanged("VIFs"); } } } private List> _VIFs = new List>() {}; /// /// virtual block devices /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VBDs { get { return _VBDs; } set { if (!Helper.AreEqual(value, _VBDs)) { _VBDs = value; Changed = true; NotifyPropertyChanged("VBDs"); } } } private List> _VBDs = new List>() {}; /// /// vitual usb devices /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VUSBs { get { return _VUSBs; } set { if (!Helper.AreEqual(value, _VUSBs)) { _VUSBs = value; Changed = true; NotifyPropertyChanged("VUSBs"); } } } private List> _VUSBs = new List>() {}; /// /// crash dumps associated with this VM /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> crash_dumps { get { return _crash_dumps; } set { if (!Helper.AreEqual(value, _crash_dumps)) { _crash_dumps = value; Changed = true; NotifyPropertyChanged("crash_dumps"); } } } private List> _crash_dumps = new List>() {}; /// /// virtual TPMs /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VTPMs { get { return _VTPMs; } set { if (!Helper.AreEqual(value, _VTPMs)) { _VTPMs = value; Changed = true; NotifyPropertyChanged("VTPMs"); } } } private List> _VTPMs = new List>() {}; /// /// name of or path to bootloader /// public virtual string PV_bootloader { get { return _PV_bootloader; } set { if (!Helper.AreEqual(value, _PV_bootloader)) { _PV_bootloader = value; Changed = true; NotifyPropertyChanged("PV_bootloader"); } } } private string _PV_bootloader = ""; /// /// path to the kernel /// public virtual string PV_kernel { get { return _PV_kernel; } set { if (!Helper.AreEqual(value, _PV_kernel)) { _PV_kernel = value; Changed = true; NotifyPropertyChanged("PV_kernel"); } } } private string _PV_kernel = ""; /// /// path to the initrd /// public virtual string PV_ramdisk { get { return _PV_ramdisk; } set { if (!Helper.AreEqual(value, _PV_ramdisk)) { _PV_ramdisk = value; Changed = true; NotifyPropertyChanged("PV_ramdisk"); } } } private string _PV_ramdisk = ""; /// /// kernel command-line arguments /// public virtual string PV_args { get { return _PV_args; } set { if (!Helper.AreEqual(value, _PV_args)) { _PV_args = value; Changed = true; NotifyPropertyChanged("PV_args"); } } } private string _PV_args = ""; /// /// miscellaneous arguments for the bootloader /// public virtual string PV_bootloader_args { get { return _PV_bootloader_args; } set { if (!Helper.AreEqual(value, _PV_bootloader_args)) { _PV_bootloader_args = value; Changed = true; NotifyPropertyChanged("PV_bootloader_args"); } } } private string _PV_bootloader_args = ""; /// /// to make Zurich guests boot /// public virtual string PV_legacy_args { get { return _PV_legacy_args; } set { if (!Helper.AreEqual(value, _PV_legacy_args)) { _PV_legacy_args = value; Changed = true; NotifyPropertyChanged("PV_legacy_args"); } } } private string _PV_legacy_args = ""; /// /// HVM boot policy /// public virtual string HVM_boot_policy { get { return _HVM_boot_policy; } set { if (!Helper.AreEqual(value, _HVM_boot_policy)) { _HVM_boot_policy = value; Changed = true; NotifyPropertyChanged("HVM_boot_policy"); } } } private string _HVM_boot_policy = ""; /// /// HVM boot params /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary HVM_boot_params { get { return _HVM_boot_params; } set { if (!Helper.AreEqual(value, _HVM_boot_params)) { _HVM_boot_params = value; Changed = true; NotifyPropertyChanged("HVM_boot_params"); } } } private Dictionary _HVM_boot_params = new Dictionary() {}; /// /// multiplier applied to the amount of shadow that will be made available to the guest /// First published in XenServer 4.1. /// public virtual double HVM_shadow_multiplier { get { return _HVM_shadow_multiplier; } set { if (!Helper.AreEqual(value, _HVM_shadow_multiplier)) { _HVM_shadow_multiplier = value; Changed = true; NotifyPropertyChanged("HVM_shadow_multiplier"); } } } private double _HVM_shadow_multiplier = 1.000; /// /// platform-specific configuration /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary platform { get { return _platform; } set { if (!Helper.AreEqual(value, _platform)) { _platform = value; Changed = true; NotifyPropertyChanged("platform"); } } } private Dictionary _platform = new Dictionary() {}; /// /// PCI bus path for pass-through devices /// public virtual string PCI_bus { get { return _PCI_bus; } set { if (!Helper.AreEqual(value, _PCI_bus)) { _PCI_bus = value; Changed = true; NotifyPropertyChanged("PCI_bus"); } } } private string _PCI_bus = ""; /// /// additional configuration /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary other_config { get { return _other_config; } set { if (!Helper.AreEqual(value, _other_config)) { _other_config = value; Changed = true; NotifyPropertyChanged("other_config"); } } } private Dictionary _other_config = new Dictionary() {}; /// /// domain ID (if available, -1 otherwise) /// public virtual long domid { get { return _domid; } set { if (!Helper.AreEqual(value, _domid)) { _domid = value; Changed = true; NotifyPropertyChanged("domid"); } } } private long _domid; /// /// Domain architecture (if available, null string otherwise) /// public virtual string domarch { get { return _domarch; } set { if (!Helper.AreEqual(value, _domarch)) { _domarch = value; Changed = true; NotifyPropertyChanged("domarch"); } } } private string _domarch = ""; /// /// describes the CPU flags on which the VM was last booted /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary last_boot_CPU_flags { get { return _last_boot_CPU_flags; } set { if (!Helper.AreEqual(value, _last_boot_CPU_flags)) { _last_boot_CPU_flags = value; Changed = true; NotifyPropertyChanged("last_boot_CPU_flags"); } } } private Dictionary _last_boot_CPU_flags = new Dictionary() {}; /// /// true if this is a control domain (domain 0 or a driver domain) /// public virtual bool is_control_domain { get { return _is_control_domain; } set { if (!Helper.AreEqual(value, _is_control_domain)) { _is_control_domain = value; Changed = true; NotifyPropertyChanged("is_control_domain"); } } } private bool _is_control_domain; /// /// metrics associated with this VM /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef metrics { get { return _metrics; } set { if (!Helper.AreEqual(value, _metrics)) { _metrics = value; Changed = true; NotifyPropertyChanged("metrics"); } } } private XenRef _metrics = new XenRef(Helper.NullOpaqueRef); /// /// metrics associated with the running guest /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef guest_metrics { get { return _guest_metrics; } set { if (!Helper.AreEqual(value, _guest_metrics)) { _guest_metrics = value; Changed = true; NotifyPropertyChanged("guest_metrics"); } } } private XenRef _guest_metrics = new XenRef(Helper.NullOpaqueRef); /// /// marshalled value containing VM record at time of last boot, updated dynamically to reflect the runtime state of the domain /// First published in XenServer 4.1. /// public virtual string last_booted_record { get { return _last_booted_record; } set { if (!Helper.AreEqual(value, _last_booted_record)) { _last_booted_record = value; Changed = true; NotifyPropertyChanged("last_booted_record"); } } } private string _last_booted_record = ""; /// /// An XML specification of recommended values and ranges for properties of this VM /// public virtual string recommendations { get { return _recommendations; } set { if (!Helper.AreEqual(value, _recommendations)) { _recommendations = value; Changed = true; NotifyPropertyChanged("recommendations"); } } } private string _recommendations = ""; /// /// data to be inserted into the xenstore tree (/local/domain/<domid>/vm-data) after the VM is created. /// First published in XenServer 4.1. /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary xenstore_data { get { return _xenstore_data; } set { if (!Helper.AreEqual(value, _xenstore_data)) { _xenstore_data = value; Changed = true; NotifyPropertyChanged("xenstore_data"); } } } private Dictionary _xenstore_data = new Dictionary() {}; /// /// if true then the system will attempt to keep the VM running as much as possible. /// First published in XenServer 5.0. /// public virtual bool ha_always_run { get { return _ha_always_run; } set { if (!Helper.AreEqual(value, _ha_always_run)) { _ha_always_run = value; Changed = true; NotifyPropertyChanged("ha_always_run"); } } } private bool _ha_always_run = false; /// /// has possible values: "best-effort" meaning "try to restart this VM if possible but don't consider the Pool to be overcommitted if this is not possible"; "restart" meaning "this VM should be restarted"; "" meaning "do not try to restart this VM" /// First published in XenServer 5.0. /// public virtual string ha_restart_priority { get { return _ha_restart_priority; } set { if (!Helper.AreEqual(value, _ha_restart_priority)) { _ha_restart_priority = value; Changed = true; NotifyPropertyChanged("ha_restart_priority"); } } } private string _ha_restart_priority = ""; /// /// true if this is a snapshot. Snapshotted VMs can never be started, they are used only for cloning other VMs /// First published in XenServer 5.0. /// public virtual bool is_a_snapshot { get { return _is_a_snapshot; } set { if (!Helper.AreEqual(value, _is_a_snapshot)) { _is_a_snapshot = value; Changed = true; NotifyPropertyChanged("is_a_snapshot"); } } } private bool _is_a_snapshot = false; /// /// Ref pointing to the VM this snapshot is of. /// First published in XenServer 5.0. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef snapshot_of { get { return _snapshot_of; } set { if (!Helper.AreEqual(value, _snapshot_of)) { _snapshot_of = value; Changed = true; NotifyPropertyChanged("snapshot_of"); } } } private XenRef _snapshot_of = new XenRef(Helper.NullOpaqueRef); /// /// List pointing to all the VM snapshots. /// First published in XenServer 5.0. /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> snapshots { get { return _snapshots; } set { if (!Helper.AreEqual(value, _snapshots)) { _snapshots = value; Changed = true; NotifyPropertyChanged("snapshots"); } } } private List> _snapshots = new List>() {}; /// /// Date/time when this snapshot was created. /// First published in XenServer 5.0. /// [JsonConverter(typeof(XenDateTimeConverter))] public virtual DateTime snapshot_time { get { return _snapshot_time; } set { if (!Helper.AreEqual(value, _snapshot_time)) { _snapshot_time = value; Changed = true; NotifyPropertyChanged("snapshot_time"); } } } private DateTime _snapshot_time = DateTime.ParseExact("19700101T00:00:00Z", "yyyyMMddTHH:mm:ssZ", CultureInfo.InvariantCulture); /// /// Transportable ID of the snapshot VM /// First published in XenServer 5.0. /// public virtual string transportable_snapshot_id { get { return _transportable_snapshot_id; } set { if (!Helper.AreEqual(value, _transportable_snapshot_id)) { _transportable_snapshot_id = value; Changed = true; NotifyPropertyChanged("transportable_snapshot_id"); } } } private string _transportable_snapshot_id = ""; /// /// Binary blobs associated with this VM /// First published in XenServer 5.0. /// [JsonConverter(typeof(StringXenRefMapConverter))] public virtual Dictionary> blobs { get { return _blobs; } set { if (!Helper.AreEqual(value, _blobs)) { _blobs = value; Changed = true; NotifyPropertyChanged("blobs"); } } } private Dictionary> _blobs = new Dictionary>() {}; /// /// user-specified tags for categorization purposes /// First published in XenServer 5.0. /// public virtual string[] tags { get { return _tags; } set { if (!Helper.AreEqual(value, _tags)) { _tags = value; Changed = true; NotifyPropertyChanged("tags"); } } } private string[] _tags = {}; /// /// List of operations which have been explicitly blocked and an error code /// First published in XenServer 5.0. /// public virtual Dictionary blocked_operations { get { return _blocked_operations; } set { if (!Helper.AreEqual(value, _blocked_operations)) { _blocked_operations = value; Changed = true; NotifyPropertyChanged("blocked_operations"); } } } private Dictionary _blocked_operations = new Dictionary() {}; /// /// Human-readable information concerning this snapshot /// First published in XenServer 5.6. /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary snapshot_info { get { return _snapshot_info; } set { if (!Helper.AreEqual(value, _snapshot_info)) { _snapshot_info = value; Changed = true; NotifyPropertyChanged("snapshot_info"); } } } private Dictionary _snapshot_info = new Dictionary() {}; /// /// Encoded information about the VM's metadata this is a snapshot of /// First published in XenServer 5.6. /// public virtual string snapshot_metadata { get { return _snapshot_metadata; } set { if (!Helper.AreEqual(value, _snapshot_metadata)) { _snapshot_metadata = value; Changed = true; NotifyPropertyChanged("snapshot_metadata"); } } } private string _snapshot_metadata = ""; /// /// Ref pointing to the parent of this VM /// First published in XenServer 5.6. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef parent { get { return _parent; } set { if (!Helper.AreEqual(value, _parent)) { _parent = value; Changed = true; NotifyPropertyChanged("parent"); } } } private XenRef _parent = new XenRef(Helper.NullOpaqueRef); /// /// List pointing to all the children of this VM /// First published in XenServer 5.6. /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> children { get { return _children; } set { if (!Helper.AreEqual(value, _children)) { _children = value; Changed = true; NotifyPropertyChanged("children"); } } } private List> _children = new List>() {}; /// /// BIOS strings /// First published in XenServer 5.6. /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary bios_strings { get { return _bios_strings; } set { if (!Helper.AreEqual(value, _bios_strings)) { _bios_strings = value; Changed = true; NotifyPropertyChanged("bios_strings"); } } } private Dictionary _bios_strings = new Dictionary() {}; /// /// Ref pointing to a protection policy for this VM /// First published in XenServer 5.6 FP1. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef protection_policy { get { return _protection_policy; } set { if (!Helper.AreEqual(value, _protection_policy)) { _protection_policy = value; Changed = true; NotifyPropertyChanged("protection_policy"); } } } private XenRef _protection_policy = new XenRef("OpaqueRef:NULL"); /// /// true if this snapshot was created by the protection policy /// First published in XenServer 5.6 FP1. /// public virtual bool is_snapshot_from_vmpp { get { return _is_snapshot_from_vmpp; } set { if (!Helper.AreEqual(value, _is_snapshot_from_vmpp)) { _is_snapshot_from_vmpp = value; Changed = true; NotifyPropertyChanged("is_snapshot_from_vmpp"); } } } private bool _is_snapshot_from_vmpp = false; /// /// Ref pointing to a snapshot schedule for this VM /// First published in XenServer 7.2. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef snapshot_schedule { get { return _snapshot_schedule; } set { if (!Helper.AreEqual(value, _snapshot_schedule)) { _snapshot_schedule = value; Changed = true; NotifyPropertyChanged("snapshot_schedule"); } } } private XenRef _snapshot_schedule = new XenRef("OpaqueRef:NULL"); /// /// true if this snapshot was created by the snapshot schedule /// First published in XenServer 7.2. /// public virtual bool is_vmss_snapshot { get { return _is_vmss_snapshot; } set { if (!Helper.AreEqual(value, _is_vmss_snapshot)) { _is_vmss_snapshot = value; Changed = true; NotifyPropertyChanged("is_vmss_snapshot"); } } } private bool _is_vmss_snapshot = false; /// /// the appliance to which this VM belongs /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef appliance { get { return _appliance; } set { if (!Helper.AreEqual(value, _appliance)) { _appliance = value; Changed = true; NotifyPropertyChanged("appliance"); } } } private XenRef _appliance = new XenRef("OpaqueRef:NULL"); /// /// The delay to wait before proceeding to the next order in the startup sequence (seconds) /// First published in XenServer 6.0. /// public virtual long start_delay { get { return _start_delay; } set { if (!Helper.AreEqual(value, _start_delay)) { _start_delay = value; Changed = true; NotifyPropertyChanged("start_delay"); } } } private long _start_delay = 0; /// /// The delay to wait before proceeding to the next order in the shutdown sequence (seconds) /// First published in XenServer 6.0. /// public virtual long shutdown_delay { get { return _shutdown_delay; } set { if (!Helper.AreEqual(value, _shutdown_delay)) { _shutdown_delay = value; Changed = true; NotifyPropertyChanged("shutdown_delay"); } } } private long _shutdown_delay = 0; /// /// The point in the startup or shutdown sequence at which this VM will be started /// First published in XenServer 6.0. /// public virtual long order { get { return _order; } set { if (!Helper.AreEqual(value, _order)) { _order = value; Changed = true; NotifyPropertyChanged("order"); } } } private long _order = 0; /// /// Virtual GPUs /// First published in XenServer 6.0. /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VGPUs { get { return _VGPUs; } set { if (!Helper.AreEqual(value, _VGPUs)) { _VGPUs = value; Changed = true; NotifyPropertyChanged("VGPUs"); } } } private List> _VGPUs = new List>() {}; /// /// Currently passed-through PCI devices /// First published in XenServer 6.0. /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> attached_PCIs { get { return _attached_PCIs; } set { if (!Helper.AreEqual(value, _attached_PCIs)) { _attached_PCIs = value; Changed = true; NotifyPropertyChanged("attached_PCIs"); } } } private List> _attached_PCIs = new List>() {}; /// /// The SR on which a suspend image is stored /// First published in XenServer 6.0. /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef suspend_SR { get { return _suspend_SR; } set { if (!Helper.AreEqual(value, _suspend_SR)) { _suspend_SR = value; Changed = true; NotifyPropertyChanged("suspend_SR"); } } } private XenRef _suspend_SR = new XenRef("OpaqueRef:NULL"); /// /// The number of times this VM has been recovered /// First published in XenServer 6.0. /// public virtual long version { get { return _version; } set { if (!Helper.AreEqual(value, _version)) { _version = value; Changed = true; NotifyPropertyChanged("version"); } } } private long _version = 0; /// /// Generation ID of the VM /// First published in XenServer 6.2. /// public virtual string generation_id { get { return _generation_id; } set { if (!Helper.AreEqual(value, _generation_id)) { _generation_id = value; Changed = true; NotifyPropertyChanged("generation_id"); } } } private string _generation_id = "0:0"; /// /// The host virtual hardware platform version the VM can run on /// First published in XenServer 6.5 SP1. /// public virtual long hardware_platform_version { get { return _hardware_platform_version; } set { if (!Helper.AreEqual(value, _hardware_platform_version)) { _hardware_platform_version = value; Changed = true; NotifyPropertyChanged("hardware_platform_version"); } } } private long _hardware_platform_version = 0; /// /// When an HVM guest starts, this controls the presence of the emulated C000 PCI device which triggers Windows Update to fetch or update PV drivers. /// First published in XenServer 7.0. /// public virtual bool has_vendor_device { get { return _has_vendor_device; } set { if (!Helper.AreEqual(value, _has_vendor_device)) { _has_vendor_device = value; Changed = true; NotifyPropertyChanged("has_vendor_device"); } } } private bool _has_vendor_device = false; /// /// Indicates whether a VM requires a reboot in order to update its configuration, e.g. its memory allocation. /// First published in XenServer 7.1. /// public virtual bool requires_reboot { get { return _requires_reboot; } set { if (!Helper.AreEqual(value, _requires_reboot)) { _requires_reboot = value; Changed = true; NotifyPropertyChanged("requires_reboot"); } } } private bool _requires_reboot = false; /// /// Textual reference to the template used to create a VM. This can be used by clients in need of an immutable reference to the template since the latter's uuid and name_label may change, for example, after a package installation or upgrade. /// First published in XenServer 7.1. /// public virtual string reference_label { get { return _reference_label; } set { if (!Helper.AreEqual(value, _reference_label)) { _reference_label = value; Changed = true; NotifyPropertyChanged("reference_label"); } } } private string _reference_label = ""; /// /// The type of domain that will be created when the VM is started /// First published in XenServer 7.5. /// [JsonConverter(typeof(domain_typeConverter))] public virtual domain_type domain_type { get { return _domain_type; } set { if (!Helper.AreEqual(value, _domain_type)) { _domain_type = value; Changed = true; NotifyPropertyChanged("domain_type"); } } } private domain_type _domain_type = domain_type.unspecified; /// /// initial value for guest NVRAM (containing UEFI variables, etc). Cannot be changed while the VM is running /// Experimental. First published in Citrix Hypervisor 8.0. /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary NVRAM { get { return _NVRAM; } set { if (!Helper.AreEqual(value, _NVRAM)) { _NVRAM = value; Changed = true; NotifyPropertyChanged("NVRAM"); } } } private Dictionary _NVRAM = new Dictionary() {}; } }