/* * Copyright (c) Cloud Software Group, Inc. * * 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 System.Linq; 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); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given VMSS. /// public override void UpdateFrom(VMSS record) { uuid = record.uuid; name_label = record.name_label; name_description = record.name_description; enabled = record.enabled; type = record.type; retained_snapshots = record.retained_snapshots; frequency = record.frequency; schedule = record.schedule; last_run_time = record.last_run_time; VMs = record.VMs; } /// /// 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); } 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) { return session.JsonRpcClient.vmss_get_record(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_by_uuid(session.opaque_ref, _uuid); } /// /// 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) { return session.JsonRpcClient.vmss_create(session.opaque_ref, _record); } /// /// 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) { return session.JsonRpcClient.async_vmss_create(session.opaque_ref, _record); } /// /// 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) { session.JsonRpcClient.vmss_destroy(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.async_vmss_destroy(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_by_name_label(session.opaque_ref, _label); } /// /// 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) { return session.JsonRpcClient.vmss_get_uuid(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_name_label(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_name_description(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_enabled(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_type(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_retained_snapshots(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_frequency(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_schedule(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_last_run_time(session.opaque_ref, _vmss); } /// /// 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) { return session.JsonRpcClient.vmss_get_vms(session.opaque_ref, _vmss); } /// /// 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) { session.JsonRpcClient.vmss_set_name_label(session.opaque_ref, _vmss, _label); } /// /// 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) { session.JsonRpcClient.vmss_set_name_description(session.opaque_ref, _vmss, _description); } /// /// 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) { session.JsonRpcClient.vmss_set_enabled(session.opaque_ref, _vmss, _enabled); } /// /// 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) { return session.JsonRpcClient.vmss_snapshot_now(session.opaque_ref, _vmss); } /// /// /// 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) { session.JsonRpcClient.vmss_set_retained_snapshots(session.opaque_ref, _vmss, _value); } /// /// 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) { session.JsonRpcClient.vmss_set_frequency(session.opaque_ref, _vmss, _value); } /// /// /// 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) { session.JsonRpcClient.vmss_set_schedule(session.opaque_ref, _vmss, _value); } /// /// /// 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) { session.JsonRpcClient.vmss_add_to_schedule(session.opaque_ref, _vmss, _key, _value); } /// /// /// 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) { session.JsonRpcClient.vmss_remove_from_schedule(session.opaque_ref, _vmss, _key); } /// /// /// 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) { session.JsonRpcClient.vmss_set_last_run_time(session.opaque_ref, _vmss, _value); } /// /// /// 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) { session.JsonRpcClient.vmss_set_type(session.opaque_ref, _vmss, _value); } /// /// 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) { return session.JsonRpcClient.vmss_get_all(session.opaque_ref); } /// /// 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) { return session.JsonRpcClient.vmss_get_all_records(session.opaque_ref); } /// /// Unique identifier/object reference /// public virtual string uuid { get { return _uuid; } set { if (!Helper.AreEqual(value, _uuid)) { _uuid = value; 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; 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; 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; 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; 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; 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; 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; 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; 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; NotifyPropertyChanged("VMs"); } } } private List> _VMs = new List>() {}; } }