/* * 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 { /// /// network-sriov which connects logical pif and physical pif /// First published in XenServer 7.5. /// public partial class Network_sriov : XenObject { #region Constructors public Network_sriov() { } public Network_sriov(string uuid, XenRef physical_PIF, XenRef logical_PIF, bool requires_reboot, sriov_configuration_mode configuration_mode) { this.uuid = uuid; this.physical_PIF = physical_PIF; this.logical_PIF = logical_PIF; this.requires_reboot = requires_reboot; this.configuration_mode = configuration_mode; } /// /// Creates a new Network_sriov from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public Network_sriov(Hashtable table) : this() { UpdateFrom(table); } /// /// Creates a new Network_sriov from a Proxy_Network_sriov. /// /// public Network_sriov(Proxy_Network_sriov proxy) { UpdateFrom(proxy); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given Network_sriov. /// public override void UpdateFrom(Network_sriov update) { uuid = update.uuid; physical_PIF = update.physical_PIF; logical_PIF = update.logical_PIF; requires_reboot = update.requires_reboot; configuration_mode = update.configuration_mode; } internal void UpdateFrom(Proxy_Network_sriov proxy) { uuid = proxy.uuid == null ? null : proxy.uuid; physical_PIF = proxy.physical_PIF == null ? null : XenRef.Create(proxy.physical_PIF); logical_PIF = proxy.logical_PIF == null ? null : XenRef.Create(proxy.logical_PIF); requires_reboot = (bool)proxy.requires_reboot; configuration_mode = proxy.configuration_mode == null ? (sriov_configuration_mode) 0 : (sriov_configuration_mode)Helper.EnumParseDefault(typeof(sriov_configuration_mode), (string)proxy.configuration_mode); } public Proxy_Network_sriov ToProxy() { Proxy_Network_sriov result_ = new Proxy_Network_sriov(); result_.uuid = uuid ?? ""; result_.physical_PIF = physical_PIF ?? ""; result_.logical_PIF = logical_PIF ?? ""; result_.requires_reboot = requires_reboot; result_.configuration_mode = sriov_configuration_mode_helper.ToString(configuration_mode); return result_; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this Network_sriov /// 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("physical_PIF")) physical_PIF = Marshalling.ParseRef(table, "physical_PIF"); if (table.ContainsKey("logical_PIF")) logical_PIF = Marshalling.ParseRef(table, "logical_PIF"); if (table.ContainsKey("requires_reboot")) requires_reboot = Marshalling.ParseBool(table, "requires_reboot"); if (table.ContainsKey("configuration_mode")) configuration_mode = (sriov_configuration_mode)Helper.EnumParseDefault(typeof(sriov_configuration_mode), Marshalling.ParseString(table, "configuration_mode")); } public bool DeepEquals(Network_sriov other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Helper.AreEqual2(this._uuid, other._uuid) && Helper.AreEqual2(this._physical_PIF, other._physical_PIF) && Helper.AreEqual2(this._logical_PIF, other._logical_PIF) && Helper.AreEqual2(this._requires_reboot, other._requires_reboot) && Helper.AreEqual2(this._configuration_mode, other._configuration_mode); } internal static List ProxyArrayToObjectList(Proxy_Network_sriov[] input) { var result = new List(); foreach (var item in input) result.Add(new Network_sriov(item)); return result; } public override string SaveChanges(Session session, string opaqueRef, Network_sriov server) { if (opaqueRef == null) { System.Diagnostics.Debug.Assert(false, "Cannot create instances of this type on the server"); return ""; } else { throw new InvalidOperationException("This type has no read/write properties"); } } /// /// Get a record containing the current state of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static Network_sriov get_record(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_record(session.opaque_ref, _network_sriov); else return new Network_sriov(session.XmlRpcProxy.network_sriov_get_record(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Get a reference to the network_sriov instance with the specified UUID. /// First published in XenServer 7.5. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_by_uuid(session.opaque_ref, _uuid); else return XenRef.Create(session.XmlRpcProxy.network_sriov_get_by_uuid(session.opaque_ref, _uuid ?? "").parse()); } /// /// Get the uuid field of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static string get_uuid(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_uuid(session.opaque_ref, _network_sriov); else return session.XmlRpcProxy.network_sriov_get_uuid(session.opaque_ref, _network_sriov ?? "").parse(); } /// /// Get the physical_PIF field of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static XenRef get_physical_PIF(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_physical_pif(session.opaque_ref, _network_sriov); else return XenRef.Create(session.XmlRpcProxy.network_sriov_get_physical_pif(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Get the logical_PIF field of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static XenRef get_logical_PIF(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_logical_pif(session.opaque_ref, _network_sriov); else return XenRef.Create(session.XmlRpcProxy.network_sriov_get_logical_pif(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Get the requires_reboot field of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static bool get_requires_reboot(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_requires_reboot(session.opaque_ref, _network_sriov); else return (bool)session.XmlRpcProxy.network_sriov_get_requires_reboot(session.opaque_ref, _network_sriov ?? "").parse(); } /// /// Get the configuration_mode field of the given network_sriov. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static sriov_configuration_mode get_configuration_mode(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_configuration_mode(session.opaque_ref, _network_sriov); else return (sriov_configuration_mode)Helper.EnumParseDefault(typeof(sriov_configuration_mode), (string)session.XmlRpcProxy.network_sriov_get_configuration_mode(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Enable SR-IOV on the specific PIF. It will create a network-sriov based on the specific PIF and automatically create a logical PIF to connect the specific network. /// First published in XenServer 7.5. /// /// The session /// PIF on which to enable SR-IOV /// Network to connect SR-IOV virtual functions with VM VIFs public static XenRef create(Session session, string _pif, string _network) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_create(session.opaque_ref, _pif, _network); else return XenRef.Create(session.XmlRpcProxy.network_sriov_create(session.opaque_ref, _pif ?? "", _network ?? "").parse()); } /// /// Enable SR-IOV on the specific PIF. It will create a network-sriov based on the specific PIF and automatically create a logical PIF to connect the specific network. /// First published in XenServer 7.5. /// /// The session /// PIF on which to enable SR-IOV /// Network to connect SR-IOV virtual functions with VM VIFs public static XenRef async_create(Session session, string _pif, string _network) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_network_sriov_create(session.opaque_ref, _pif, _network); else return XenRef.Create(session.XmlRpcProxy.async_network_sriov_create(session.opaque_ref, _pif ?? "", _network ?? "").parse()); } /// /// Disable SR-IOV on the specific PIF. It will destroy the network-sriov and the logical PIF accordingly. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static void destroy(Session session, string _network_sriov) { if (session.JsonRpcClient != null) session.JsonRpcClient.network_sriov_destroy(session.opaque_ref, _network_sriov); else session.XmlRpcProxy.network_sriov_destroy(session.opaque_ref, _network_sriov ?? "").parse(); } /// /// Disable SR-IOV on the specific PIF. It will destroy the network-sriov and the logical PIF accordingly. /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static XenRef async_destroy(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_network_sriov_destroy(session.opaque_ref, _network_sriov); else return XenRef.Create(session.XmlRpcProxy.async_network_sriov_destroy(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Get the number of free SR-IOV VFs on the associated PIF /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static long get_remaining_capacity(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_remaining_capacity(session.opaque_ref, _network_sriov); else return long.Parse(session.XmlRpcProxy.network_sriov_get_remaining_capacity(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Get the number of free SR-IOV VFs on the associated PIF /// First published in XenServer 7.5. /// /// The session /// The opaque_ref of the given network_sriov public static XenRef async_get_remaining_capacity(Session session, string _network_sriov) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_network_sriov_get_remaining_capacity(session.opaque_ref, _network_sriov); else return XenRef.Create(session.XmlRpcProxy.async_network_sriov_get_remaining_capacity(session.opaque_ref, _network_sriov ?? "").parse()); } /// /// Return a list of all the network_sriovs known to the system. /// First published in XenServer 7.5. /// /// The session public static List> get_all(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_all(session.opaque_ref); else return XenRef.Create(session.XmlRpcProxy.network_sriov_get_all(session.opaque_ref).parse()); } /// /// Get all the network_sriov Records at once, in a single XML RPC call /// First published in XenServer 7.5. /// /// The session public static Dictionary, Network_sriov> get_all_records(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.network_sriov_get_all_records(session.opaque_ref); else return XenRef.Create(session.XmlRpcProxy.network_sriov_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 = ""; /// /// The PIF that has SR-IOV enabled /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef physical_PIF { get { return _physical_PIF; } set { if (!Helper.AreEqual(value, _physical_PIF)) { _physical_PIF = value; NotifyPropertyChanged("physical_PIF"); } } } private XenRef _physical_PIF = new XenRef(Helper.NullOpaqueRef); /// /// The logical PIF to connect to the SR-IOV network after enable SR-IOV on the physical PIF /// [JsonConverter(typeof(XenRefConverter))] public virtual XenRef logical_PIF { get { return _logical_PIF; } set { if (!Helper.AreEqual(value, _logical_PIF)) { _logical_PIF = value; NotifyPropertyChanged("logical_PIF"); } } } private XenRef _logical_PIF = new XenRef(Helper.NullOpaqueRef); /// /// Indicates whether the host need to be rebooted before SR-IOV is enabled on the physical PIF /// public virtual bool requires_reboot { get { return _requires_reboot; } set { if (!Helper.AreEqual(value, _requires_reboot)) { _requires_reboot = value; NotifyPropertyChanged("requires_reboot"); } } } private bool _requires_reboot = false; /// /// The mode for configure network sriov /// [JsonConverter(typeof(sriov_configuration_modeConverter))] public virtual sriov_configuration_mode configuration_mode { get { return _configuration_mode; } set { if (!Helper.AreEqual(value, _configuration_mode)) { _configuration_mode = value; NotifyPropertyChanged("configuration_mode"); } } } private sriov_configuration_mode _configuration_mode = sriov_configuration_mode.unknown; } }