/* * 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 { /// /// VM Snapshot Schedule /// First published in XenServer 7.2. /// public partial class VMSS : XenObject { #region Constructors public VMSS() { } public VMSS(string uuid, string name_label, string name_description, bool enabled, vmss_type type, long retained_snapshots, vmss_frequency frequency, Dictionary schedule, DateTime last_run_time, List> VMs) { this.uuid = uuid; this.name_label = name_label; this.name_description = name_description; this.enabled = enabled; this.type = type; this.retained_snapshots = retained_snapshots; this.frequency = frequency; this.schedule = schedule; this.last_run_time = last_run_time; this.VMs = VMs; } /// /// Creates a new VMSS from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public VMSS(Hashtable table) : this() { UpdateFrom(table); } /// /// Creates a new VMSS from a Proxy_VMSS. /// /// public VMSS(Proxy_VMSS proxy) { UpdateFrom(proxy); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given VMSS. /// public override void UpdateFrom(VMSS update) { uuid = update.uuid; name_label = update.name_label; name_description = update.name_description; enabled = update.enabled; type = update.type; retained_snapshots = update.retained_snapshots; frequency = update.frequency; schedule = update.schedule; last_run_time = update.last_run_time; VMs = update.VMs; } internal void UpdateFrom(Proxy_VMSS proxy) { uuid = proxy.uuid == null ? null : proxy.uuid; name_label = proxy.name_label == null ? null : proxy.name_label; name_description = proxy.name_description == null ? null : proxy.name_description; enabled = (bool)proxy.enabled; type = proxy.type == null ? (vmss_type) 0 : (vmss_type)Helper.EnumParseDefault(typeof(vmss_type), (string)proxy.type); retained_snapshots = proxy.retained_snapshots == null ? 0 : long.Parse(proxy.retained_snapshots); frequency = proxy.frequency == null ? (vmss_frequency) 0 : (vmss_frequency)Helper.EnumParseDefault(typeof(vmss_frequency), (string)proxy.frequency); schedule = proxy.schedule == null ? null : Maps.convert_from_proxy_string_string(proxy.schedule); last_run_time = proxy.last_run_time; VMs = proxy.VMs == null ? null : XenRef.Create(proxy.VMs); } public Proxy_VMSS ToProxy() { Proxy_VMSS result_ = new Proxy_VMSS(); result_.uuid = uuid ?? ""; result_.name_label = name_label ?? ""; result_.name_description = name_description ?? ""; result_.enabled = enabled; result_.type = vmss_type_helper.ToString(type); result_.retained_snapshots = retained_snapshots.ToString(); result_.frequency = vmss_frequency_helper.ToString(frequency); result_.schedule = Maps.convert_to_proxy_string_string(schedule); result_.last_run_time = last_run_time; result_.VMs = VMs == null ? new string[] {} : Helper.RefListToStringArray(VMs); return result_; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this VMSS /// 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("name_label")) name_label = Marshalling.ParseString(table, "name_label"); if (table.ContainsKey("name_description")) name_description = Marshalling.ParseString(table, "name_description"); if (table.ContainsKey("enabled")) enabled = Marshalling.ParseBool(table, "enabled"); if (table.ContainsKey("type")) type = (vmss_type)Helper.EnumParseDefault(typeof(vmss_type), Marshalling.ParseString(table, "type")); if (table.ContainsKey("retained_snapshots")) retained_snapshots = Marshalling.ParseLong(table, "retained_snapshots"); if (table.ContainsKey("frequency")) frequency = (vmss_frequency)Helper.EnumParseDefault(typeof(vmss_frequency), Marshalling.ParseString(table, "frequency")); if (table.ContainsKey("schedule")) schedule = Maps.convert_from_proxy_string_string(Marshalling.ParseHashTable(table, "schedule")); if (table.ContainsKey("last_run_time")) last_run_time = Marshalling.ParseDateTime(table, "last_run_time"); if (table.ContainsKey("VMs")) VMs = Marshalling.ParseSetRef(table, "VMs"); } public bool DeepEquals(VMSS other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Helper.AreEqual2(this._uuid, other._uuid) && Helper.AreEqual2(this._name_label, other._name_label) && Helper.AreEqual2(this._name_description, other._name_description) && Helper.AreEqual2(this._enabled, other._enabled) && Helper.AreEqual2(this._type, other._type) && Helper.AreEqual2(this._retained_snapshots, other._retained_snapshots) && Helper.AreEqual2(this._frequency, other._frequency) && Helper.AreEqual2(this._schedule, other._schedule) && Helper.AreEqual2(this._last_run_time, other._last_run_time) && Helper.AreEqual2(this._VMs, other._VMs); } internal static List ProxyArrayToObjectList(Proxy_VMSS[] input) { var result = new List(); foreach (var item in input) result.Add(new VMSS(item)); return result; } public override string SaveChanges(Session session, string opaqueRef, VMSS 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)) { VMSS.set_name_label(session, opaqueRef, _name_label); } if (!Helper.AreEqual2(_name_description, server._name_description)) { VMSS.set_name_description(session, opaqueRef, _name_description); } if (!Helper.AreEqual2(_enabled, server._enabled)) { VMSS.set_enabled(session, opaqueRef, _enabled); } if (!Helper.AreEqual2(_type, server._type)) { VMSS.set_type(session, opaqueRef, _type); } if (!Helper.AreEqual2(_retained_snapshots, server._retained_snapshots)) { VMSS.set_retained_snapshots(session, opaqueRef, _retained_snapshots); } if (!Helper.AreEqual2(_frequency, server._frequency)) { VMSS.set_frequency(session, opaqueRef, _frequency); } if (!Helper.AreEqual2(_schedule, server._schedule)) { VMSS.set_schedule(session, opaqueRef, _schedule); } return null; } } /// /// Get a record containing the current state of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static VMSS get_record(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_record(session.opaque_ref, _vmss); else return new VMSS(session.proxy.vmss_get_record(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get a reference to the VMSS instance with the specified UUID. /// First published in XenServer 7.2. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_by_uuid(session.opaque_ref, _uuid); else return XenRef.Create(session.proxy.vmss_get_by_uuid(session.opaque_ref, _uuid ?? "").parse()); } /// /// Create a new VMSS instance, and return its handle. /// First published in XenServer 7.2. /// /// The session /// All constructor arguments public static XenRef create(Session session, VMSS _record) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_create(session.opaque_ref, _record); else return XenRef.Create(session.proxy.vmss_create(session.opaque_ref, _record.ToProxy()).parse()); } /// /// Create a new VMSS instance, and return its handle. /// First published in XenServer 7.2. /// /// The session /// All constructor arguments public static XenRef async_create(Session session, VMSS _record) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vmss_create(session.opaque_ref, _record); else return XenRef.Create(session.proxy.async_vmss_create(session.opaque_ref, _record.ToProxy()).parse()); } /// /// Destroy the specified VMSS instance. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static void destroy(Session session, string _vmss) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_destroy(session.opaque_ref, _vmss); else session.proxy.vmss_destroy(session.opaque_ref, _vmss ?? "").parse(); } /// /// Destroy the specified VMSS instance. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static XenRef async_destroy(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_vmss_destroy(session.opaque_ref, _vmss); else return XenRef.Create(session.proxy.async_vmss_destroy(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get all the VMSS instances with the given label. /// First published in XenServer 7.2. /// /// 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.vmss_get_by_name_label(session.opaque_ref, _label); else return XenRef.Create(session.proxy.vmss_get_by_name_label(session.opaque_ref, _label ?? "").parse()); } /// /// Get the uuid field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static string get_uuid(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_uuid(session.opaque_ref, _vmss); else return session.proxy.vmss_get_uuid(session.opaque_ref, _vmss ?? "").parse(); } /// /// Get the name/label field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static string get_name_label(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_name_label(session.opaque_ref, _vmss); else return session.proxy.vmss_get_name_label(session.opaque_ref, _vmss ?? "").parse(); } /// /// Get the name/description field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static string get_name_description(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_name_description(session.opaque_ref, _vmss); else return session.proxy.vmss_get_name_description(session.opaque_ref, _vmss ?? "").parse(); } /// /// Get the enabled field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static bool get_enabled(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_enabled(session.opaque_ref, _vmss); else return (bool)session.proxy.vmss_get_enabled(session.opaque_ref, _vmss ?? "").parse(); } /// /// Get the type field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static vmss_type get_type(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_type(session.opaque_ref, _vmss); else return (vmss_type)Helper.EnumParseDefault(typeof(vmss_type), (string)session.proxy.vmss_get_type(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get the retained_snapshots field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static long get_retained_snapshots(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_retained_snapshots(session.opaque_ref, _vmss); else return long.Parse(session.proxy.vmss_get_retained_snapshots(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get the frequency field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static vmss_frequency get_frequency(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_frequency(session.opaque_ref, _vmss); else return (vmss_frequency)Helper.EnumParseDefault(typeof(vmss_frequency), (string)session.proxy.vmss_get_frequency(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get the schedule field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static Dictionary get_schedule(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_schedule(session.opaque_ref, _vmss); else return Maps.convert_from_proxy_string_string(session.proxy.vmss_get_schedule(session.opaque_ref, _vmss ?? "").parse()); } /// /// Get the last_run_time field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static DateTime get_last_run_time(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_last_run_time(session.opaque_ref, _vmss); else return session.proxy.vmss_get_last_run_time(session.opaque_ref, _vmss ?? "").parse(); } /// /// Get the VMs field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static List> get_VMs(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_vms(session.opaque_ref, _vmss); else return XenRef.Create(session.proxy.vmss_get_vms(session.opaque_ref, _vmss ?? "").parse()); } /// /// Set the name/label field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// New value to set public static void set_name_label(Session session, string _vmss, string _label) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_name_label(session.opaque_ref, _vmss, _label); else session.proxy.vmss_set_name_label(session.opaque_ref, _vmss ?? "", _label ?? "").parse(); } /// /// Set the name/description field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// New value to set public static void set_name_description(Session session, string _vmss, string _description) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_name_description(session.opaque_ref, _vmss, _description); else session.proxy.vmss_set_name_description(session.opaque_ref, _vmss ?? "", _description ?? "").parse(); } /// /// Set the enabled field of the given VMSS. /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// New value to set public static void set_enabled(Session session, string _vmss, bool _enabled) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_enabled(session.opaque_ref, _vmss, _enabled); else session.proxy.vmss_set_enabled(session.opaque_ref, _vmss ?? "", _enabled).parse(); } /// /// This call executes the snapshot schedule immediately /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss public static string snapshot_now(Session session, string _vmss) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_snapshot_now(session.opaque_ref, _vmss); else return session.proxy.vmss_snapshot_now(session.opaque_ref, _vmss ?? "").parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the value to set public static void set_retained_snapshots(Session session, string _vmss, long _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_retained_snapshots(session.opaque_ref, _vmss, _value); else session.proxy.vmss_set_retained_snapshots(session.opaque_ref, _vmss ?? "", _value.ToString()).parse(); } /// /// Set the value of the frequency field /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the snapshot schedule frequency public static void set_frequency(Session session, string _vmss, vmss_frequency _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_frequency(session.opaque_ref, _vmss, _value); else session.proxy.vmss_set_frequency(session.opaque_ref, _vmss ?? "", vmss_frequency_helper.ToString(_value)).parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the value to set public static void set_schedule(Session session, string _vmss, Dictionary _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_schedule(session.opaque_ref, _vmss, _value); else session.proxy.vmss_set_schedule(session.opaque_ref, _vmss ?? "", Maps.convert_to_proxy_string_string(_value)).parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the key to add /// the value to add public static void add_to_schedule(Session session, string _vmss, string _key, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_add_to_schedule(session.opaque_ref, _vmss, _key, _value); else session.proxy.vmss_add_to_schedule(session.opaque_ref, _vmss ?? "", _key ?? "", _value ?? "").parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the key to remove public static void remove_from_schedule(Session session, string _vmss, string _key) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_remove_from_schedule(session.opaque_ref, _vmss, _key); else session.proxy.vmss_remove_from_schedule(session.opaque_ref, _vmss ?? "", _key ?? "").parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the value to set public static void set_last_run_time(Session session, string _vmss, DateTime _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_last_run_time(session.opaque_ref, _vmss, _value); else session.proxy.vmss_set_last_run_time(session.opaque_ref, _vmss ?? "", _value).parse(); } /// /// /// First published in XenServer 7.2. /// /// The session /// The opaque_ref of the given vmss /// the snapshot schedule type public static void set_type(Session session, string _vmss, vmss_type _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.vmss_set_type(session.opaque_ref, _vmss, _value); else session.proxy.vmss_set_type(session.opaque_ref, _vmss ?? "", vmss_type_helper.ToString(_value)).parse(); } /// /// Return a list of all the VMSSs known to the system. /// First published in XenServer 7.2. /// /// The session public static List> get_all(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_all(session.opaque_ref); else return XenRef.Create(session.proxy.vmss_get_all(session.opaque_ref).parse()); } /// /// Get all the VMSS Records at once, in a single XML RPC call /// First published in XenServer 7.2. /// /// The session public static Dictionary, VMSS> get_all_records(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.vmss_get_all_records(session.opaque_ref); else return XenRef.Create(session.proxy.vmss_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 = ""; /// /// 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 = ""; /// /// enable or disable this snapshot schedule /// public virtual bool enabled { get { return _enabled; } set { if (!Helper.AreEqual(value, _enabled)) { _enabled = value; Changed = true; NotifyPropertyChanged("enabled"); } } } private bool _enabled = true; /// /// type of the snapshot schedule /// [JsonConverter(typeof(vmss_typeConverter))] public virtual vmss_type type { get { return _type; } set { if (!Helper.AreEqual(value, _type)) { _type = value; Changed = true; NotifyPropertyChanged("type"); } } } private vmss_type _type; /// /// maximum number of snapshots that should be stored at any time /// public virtual long retained_snapshots { get { return _retained_snapshots; } set { if (!Helper.AreEqual(value, _retained_snapshots)) { _retained_snapshots = value; Changed = true; NotifyPropertyChanged("retained_snapshots"); } } } private long _retained_snapshots = 7; /// /// frequency of taking snapshot from snapshot schedule /// [JsonConverter(typeof(vmss_frequencyConverter))] public virtual vmss_frequency frequency { get { return _frequency; } set { if (!Helper.AreEqual(value, _frequency)) { _frequency = value; Changed = true; NotifyPropertyChanged("frequency"); } } } private vmss_frequency _frequency; /// /// schedule of the snapshot containing 'hour', 'min', 'days'. Date/time-related information is in Local Timezone /// [JsonConverter(typeof(StringStringMapConverter))] public virtual Dictionary schedule { get { return _schedule; } set { if (!Helper.AreEqual(value, _schedule)) { _schedule = value; Changed = true; NotifyPropertyChanged("schedule"); } } } private Dictionary _schedule = new Dictionary() {}; /// /// time of the last snapshot /// [JsonConverter(typeof(XenDateTimeConverter))] public virtual DateTime last_run_time { get { return _last_run_time; } set { if (!Helper.AreEqual(value, _last_run_time)) { _last_run_time = value; Changed = true; NotifyPropertyChanged("last_run_time"); } } } private DateTime _last_run_time = DateTime.ParseExact("19700101T00:00:00Z", "yyyyMMddTHH:mm:ssZ", CultureInfo.InvariantCulture); /// /// all VMs attached to this snapshot schedule /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> VMs { get { return _VMs; } set { if (!Helper.AreEqual(value, _VMs)) { _VMs = value; Changed = true; NotifyPropertyChanged("VMs"); } } } private List> _VMs = new List>() {}; } }