/* * 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 { /// /// machines serving blocks of data for provisioning VMs /// First published in XenServer 7.1. /// public partial class PVS_site : XenObject { #region Constructors public PVS_site() { } public PVS_site(string uuid, string name_label, string name_description, string PVS_uuid, List> cache_storage, List> servers, List> proxies) { this.uuid = uuid; this.name_label = name_label; this.name_description = name_description; this.PVS_uuid = PVS_uuid; this.cache_storage = cache_storage; this.servers = servers; this.proxies = proxies; } /// /// Creates a new PVS_site from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public PVS_site(Hashtable table) : this() { UpdateFrom(table); } /// /// Creates a new PVS_site from a Proxy_PVS_site. /// /// public PVS_site(Proxy_PVS_site proxy) { UpdateFrom(proxy); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given PVS_site. /// public override void UpdateFrom(PVS_site update) { uuid = update.uuid; name_label = update.name_label; name_description = update.name_description; PVS_uuid = update.PVS_uuid; cache_storage = update.cache_storage; servers = update.servers; proxies = update.proxies; } internal void UpdateFrom(Proxy_PVS_site 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; PVS_uuid = proxy.PVS_uuid == null ? null : proxy.PVS_uuid; cache_storage = proxy.cache_storage == null ? null : XenRef.Create(proxy.cache_storage); servers = proxy.servers == null ? null : XenRef.Create(proxy.servers); proxies = proxy.proxies == null ? null : XenRef.Create(proxy.proxies); } public Proxy_PVS_site ToProxy() { Proxy_PVS_site result_ = new Proxy_PVS_site(); result_.uuid = uuid ?? ""; result_.name_label = name_label ?? ""; result_.name_description = name_description ?? ""; result_.PVS_uuid = PVS_uuid ?? ""; result_.cache_storage = cache_storage == null ? new string[] {} : Helper.RefListToStringArray(cache_storage); result_.servers = servers == null ? new string[] {} : Helper.RefListToStringArray(servers); result_.proxies = proxies == null ? new string[] {} : Helper.RefListToStringArray(proxies); return result_; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this PVS_site /// 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("PVS_uuid")) PVS_uuid = Marshalling.ParseString(table, "PVS_uuid"); if (table.ContainsKey("cache_storage")) cache_storage = Marshalling.ParseSetRef(table, "cache_storage"); if (table.ContainsKey("servers")) servers = Marshalling.ParseSetRef(table, "servers"); if (table.ContainsKey("proxies")) proxies = Marshalling.ParseSetRef(table, "proxies"); } public bool DeepEquals(PVS_site 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._PVS_uuid, other._PVS_uuid) && Helper.AreEqual2(this._cache_storage, other._cache_storage) && Helper.AreEqual2(this._servers, other._servers) && Helper.AreEqual2(this._proxies, other._proxies); } internal static List ProxyArrayToObjectList(Proxy_PVS_site[] input) { var result = new List(); foreach (var item in input) result.Add(new PVS_site(item)); return result; } public override string SaveChanges(Session session, string opaqueRef, PVS_site server) { if (opaqueRef == null) { System.Diagnostics.Debug.Assert(false, "Cannot create instances of this type on the server"); return ""; } else { if (!Helper.AreEqual2(_name_label, server._name_label)) { PVS_site.set_name_label(session, opaqueRef, _name_label); } if (!Helper.AreEqual2(_name_description, server._name_description)) { PVS_site.set_name_description(session, opaqueRef, _name_description); } if (!Helper.AreEqual2(_PVS_uuid, server._PVS_uuid)) { PVS_site.set_PVS_uuid(session, opaqueRef, _PVS_uuid); } return null; } } /// /// Get a record containing the current state of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static PVS_site get_record(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_record(session.opaque_ref, _pvs_site); else return new PVS_site(session.XmlRpcProxy.pvs_site_get_record(session.opaque_ref, _pvs_site ?? "").parse()); } /// /// Get a reference to the PVS_site instance with the specified UUID. /// First published in XenServer 7.1. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_by_uuid(session.opaque_ref, _uuid); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_by_uuid(session.opaque_ref, _uuid ?? "").parse()); } /// /// Get all the PVS_site instances with the given label. /// First published in XenServer 7.1. /// /// 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.pvs_site_get_by_name_label(session.opaque_ref, _label); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_by_name_label(session.opaque_ref, _label ?? "").parse()); } /// /// Get the uuid field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static string get_uuid(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_uuid(session.opaque_ref, _pvs_site); else return session.XmlRpcProxy.pvs_site_get_uuid(session.opaque_ref, _pvs_site ?? "").parse(); } /// /// Get the name/label field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static string get_name_label(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_name_label(session.opaque_ref, _pvs_site); else return session.XmlRpcProxy.pvs_site_get_name_label(session.opaque_ref, _pvs_site ?? "").parse(); } /// /// Get the name/description field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static string get_name_description(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_name_description(session.opaque_ref, _pvs_site); else return session.XmlRpcProxy.pvs_site_get_name_description(session.opaque_ref, _pvs_site ?? "").parse(); } /// /// Get the PVS_uuid field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static string get_PVS_uuid(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_pvs_uuid(session.opaque_ref, _pvs_site); else return session.XmlRpcProxy.pvs_site_get_pvs_uuid(session.opaque_ref, _pvs_site ?? "").parse(); } /// /// Get the cache_storage field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static List> get_cache_storage(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_cache_storage(session.opaque_ref, _pvs_site); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_cache_storage(session.opaque_ref, _pvs_site ?? "").parse()); } /// /// Get the servers field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static List> get_servers(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_servers(session.opaque_ref, _pvs_site); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_servers(session.opaque_ref, _pvs_site ?? "").parse()); } /// /// Get the proxies field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static List> get_proxies(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_proxies(session.opaque_ref, _pvs_site); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_proxies(session.opaque_ref, _pvs_site ?? "").parse()); } /// /// Set the name/label field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site /// New value to set public static void set_name_label(Session session, string _pvs_site, string _label) { if (session.JsonRpcClient != null) session.JsonRpcClient.pvs_site_set_name_label(session.opaque_ref, _pvs_site, _label); else session.XmlRpcProxy.pvs_site_set_name_label(session.opaque_ref, _pvs_site ?? "", _label ?? "").parse(); } /// /// Set the name/description field of the given PVS_site. /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site /// New value to set public static void set_name_description(Session session, string _pvs_site, string _description) { if (session.JsonRpcClient != null) session.JsonRpcClient.pvs_site_set_name_description(session.opaque_ref, _pvs_site, _description); else session.XmlRpcProxy.pvs_site_set_name_description(session.opaque_ref, _pvs_site ?? "", _description ?? "").parse(); } /// /// Introduce new PVS site /// First published in XenServer 7.1. /// /// The session /// name of the PVS site /// description of the PVS site /// unique identifier of the PVS site public static XenRef introduce(Session session, string _name_label, string _name_description, string _pvs_uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_introduce(session.opaque_ref, _name_label, _name_description, _pvs_uuid); else return XenRef.Create(session.XmlRpcProxy.pvs_site_introduce(session.opaque_ref, _name_label ?? "", _name_description ?? "", _pvs_uuid ?? "").parse()); } /// /// Introduce new PVS site /// First published in XenServer 7.1. /// /// The session /// name of the PVS site /// description of the PVS site /// unique identifier of the PVS site public static XenRef async_introduce(Session session, string _name_label, string _name_description, string _pvs_uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_pvs_site_introduce(session.opaque_ref, _name_label, _name_description, _pvs_uuid); else return XenRef.Create(session.XmlRpcProxy.async_pvs_site_introduce(session.opaque_ref, _name_label ?? "", _name_description ?? "", _pvs_uuid ?? "").parse()); } /// /// Remove a site's meta data /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static void forget(Session session, string _pvs_site) { if (session.JsonRpcClient != null) session.JsonRpcClient.pvs_site_forget(session.opaque_ref, _pvs_site); else session.XmlRpcProxy.pvs_site_forget(session.opaque_ref, _pvs_site ?? "").parse(); } /// /// Remove a site's meta data /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site public static XenRef async_forget(Session session, string _pvs_site) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_pvs_site_forget(session.opaque_ref, _pvs_site); else return XenRef.Create(session.XmlRpcProxy.async_pvs_site_forget(session.opaque_ref, _pvs_site ?? "").parse()); } /// /// Update the PVS UUID of the PVS site /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site /// PVS UUID to be used public static void set_PVS_uuid(Session session, string _pvs_site, string _value) { if (session.JsonRpcClient != null) session.JsonRpcClient.pvs_site_set_pvs_uuid(session.opaque_ref, _pvs_site, _value); else session.XmlRpcProxy.pvs_site_set_pvs_uuid(session.opaque_ref, _pvs_site ?? "", _value ?? "").parse(); } /// /// Update the PVS UUID of the PVS site /// First published in XenServer 7.1. /// /// The session /// The opaque_ref of the given pvs_site /// PVS UUID to be used public static XenRef async_set_PVS_uuid(Session session, string _pvs_site, string _value) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_pvs_site_set_pvs_uuid(session.opaque_ref, _pvs_site, _value); else return XenRef.Create(session.XmlRpcProxy.async_pvs_site_set_pvs_uuid(session.opaque_ref, _pvs_site ?? "", _value ?? "").parse()); } /// /// Return a list of all the PVS_sites known to the system. /// First published in XenServer 7.1. /// /// The session public static List> get_all(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_all(session.opaque_ref); else return XenRef.Create(session.XmlRpcProxy.pvs_site_get_all(session.opaque_ref).parse()); } /// /// Get all the PVS_site Records at once, in a single XML RPC call /// First published in XenServer 7.1. /// /// The session public static Dictionary, PVS_site> get_all_records(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.pvs_site_get_all_records(session.opaque_ref); else return XenRef.Create(session.XmlRpcProxy.pvs_site_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; 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 = ""; /// /// Unique identifier of the PVS site, as configured in PVS /// public virtual string PVS_uuid { get { return _PVS_uuid; } set { if (!Helper.AreEqual(value, _PVS_uuid)) { _PVS_uuid = value; NotifyPropertyChanged("PVS_uuid"); } } } private string _PVS_uuid = ""; /// /// The SR used by PVS proxy for the cache /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> cache_storage { get { return _cache_storage; } set { if (!Helper.AreEqual(value, _cache_storage)) { _cache_storage = value; NotifyPropertyChanged("cache_storage"); } } } private List> _cache_storage = new List>() {}; /// /// The set of PVS servers in the site /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> servers { get { return _servers; } set { if (!Helper.AreEqual(value, _servers)) { _servers = value; NotifyPropertyChanged("servers"); } } } private List> _servers = new List>() {}; /// /// The set of proxies associated with the site /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> proxies { get { return _proxies; } set { if (!Helper.AreEqual(value, _proxies)) { _proxies = value; NotifyPropertyChanged("proxies"); } } } private List> _proxies = new List>() {}; } }