/* * 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 { /// /// DR task /// First published in XenServer 6.0. /// public partial class DR_task : XenObject { public DR_task() { } public DR_task(string uuid, List> introduced_SRs) { this.uuid = uuid; this.introduced_SRs = introduced_SRs; } /// /// Creates a new DR_task from a Proxy_DR_task. /// /// public DR_task(Proxy_DR_task proxy) { this.UpdateFromProxy(proxy); } /// /// Updates each field of this instance with the value of /// the corresponding field of a given DR_task. /// public override void UpdateFrom(DR_task update) { uuid = update.uuid; introduced_SRs = update.introduced_SRs; } internal void UpdateFromProxy(Proxy_DR_task proxy) { uuid = proxy.uuid == null ? null : proxy.uuid; introduced_SRs = proxy.introduced_SRs == null ? null : XenRef.Create(proxy.introduced_SRs); } public Proxy_DR_task ToProxy() { Proxy_DR_task result_ = new Proxy_DR_task(); result_.uuid = uuid ?? ""; result_.introduced_SRs = introduced_SRs == null ? new string[] {} : Helper.RefListToStringArray(introduced_SRs); return result_; } /// /// Creates a new DR_task from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public DR_task(Hashtable table) : this() { UpdateFrom(table); } /// /// Given a Hashtable with field-value pairs, it updates the fields of this DR_task /// 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("introduced_SRs")) introduced_SRs = Marshalling.ParseSetRef(table, "introduced_SRs"); } public bool DeepEquals(DR_task other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Helper.AreEqual2(this._uuid, other._uuid) && Helper.AreEqual2(this._introduced_SRs, other._introduced_SRs); } internal static List ProxyArrayToObjectList(Proxy_DR_task[] input) { var result = new List(); foreach (var item in input) result.Add(new DR_task(item)); return result; } public override string SaveChanges(Session session, string opaqueRef, DR_task 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 DR_task. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given dr_task public static DR_task get_record(Session session, string _dr_task) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_get_record(session.opaque_ref, _dr_task); else return new DR_task(session.proxy.dr_task_get_record(session.opaque_ref, _dr_task ?? "").parse()); } /// /// Get a reference to the DR_task instance with the specified UUID. /// First published in XenServer 6.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.dr_task_get_by_uuid(session.opaque_ref, _uuid); else return XenRef.Create(session.proxy.dr_task_get_by_uuid(session.opaque_ref, _uuid ?? "").parse()); } /// /// Get the uuid field of the given DR_task. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given dr_task public static string get_uuid(Session session, string _dr_task) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_get_uuid(session.opaque_ref, _dr_task); else return session.proxy.dr_task_get_uuid(session.opaque_ref, _dr_task ?? "").parse(); } /// /// Get the introduced_SRs field of the given DR_task. /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given dr_task public static List> get_introduced_SRs(Session session, string _dr_task) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_get_introduced_srs(session.opaque_ref, _dr_task); else return XenRef.Create(session.proxy.dr_task_get_introduced_srs(session.opaque_ref, _dr_task ?? "").parse()); } /// /// Create a disaster recovery task which will query the supplied list of devices /// First published in XenServer 6.0. /// /// The session /// The SR driver type of the SRs to introduce /// The device configuration of the SRs to introduce /// The devices to use for disaster recovery public static XenRef create(Session session, string _type, Dictionary _device_config, string[] _whitelist) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_create(session.opaque_ref, _type, _device_config, _whitelist); else return XenRef.Create(session.proxy.dr_task_create(session.opaque_ref, _type ?? "", Maps.convert_to_proxy_string_string(_device_config), _whitelist).parse()); } /// /// Create a disaster recovery task which will query the supplied list of devices /// First published in XenServer 6.0. /// /// The session /// The SR driver type of the SRs to introduce /// The device configuration of the SRs to introduce /// The devices to use for disaster recovery public static XenRef async_create(Session session, string _type, Dictionary _device_config, string[] _whitelist) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_dr_task_create(session.opaque_ref, _type, _device_config, _whitelist); else return XenRef.Create(session.proxy.async_dr_task_create(session.opaque_ref, _type ?? "", Maps.convert_to_proxy_string_string(_device_config), _whitelist).parse()); } /// /// Destroy the disaster recovery task, detaching and forgetting any SRs introduced which are no longer required /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given dr_task public static void destroy(Session session, string _dr_task) { if (session.JsonRpcClient != null) session.JsonRpcClient.dr_task_destroy(session.opaque_ref, _dr_task); else session.proxy.dr_task_destroy(session.opaque_ref, _dr_task ?? "").parse(); } /// /// Destroy the disaster recovery task, detaching and forgetting any SRs introduced which are no longer required /// First published in XenServer 6.0. /// /// The session /// The opaque_ref of the given dr_task public static XenRef async_destroy(Session session, string _dr_task) { if (session.JsonRpcClient != null) return session.JsonRpcClient.async_dr_task_destroy(session.opaque_ref, _dr_task); else return XenRef.Create(session.proxy.async_dr_task_destroy(session.opaque_ref, _dr_task ?? "").parse()); } /// /// Return a list of all the DR_tasks known to the system. /// First published in XenServer 6.0. /// /// The session public static List> get_all(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_get_all(session.opaque_ref); else return XenRef.Create(session.proxy.dr_task_get_all(session.opaque_ref).parse()); } /// /// Get all the DR_task Records at once, in a single XML RPC call /// First published in XenServer 6.0. /// /// The session public static Dictionary, DR_task> get_all_records(Session session) { if (session.JsonRpcClient != null) return session.JsonRpcClient.dr_task_get_all_records(session.opaque_ref); else return XenRef.Create(session.proxy.dr_task_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 = ""; /// /// All SRs introduced by this appliance /// [JsonConverter(typeof(XenRefListConverter))] public virtual List> introduced_SRs { get { return _introduced_SRs; } set { if (!Helper.AreEqual(value, _introduced_SRs)) { _introduced_SRs = value; Changed = true; NotifyPropertyChanged("introduced_SRs"); } } } private List> _introduced_SRs = new List>() {}; } }