comet_backup_ruby_sdk 2.41.0 → 2.43.0

data/lib/comet/models/pvedisk.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # PVEDisk is a typed class wrapper around the underlying Comet Server API data structure.
+  class PVEDisk
+
+    # @type [String] device
+    attr_accessor :device
+
+    # @type [Number] device_num
+    attr_accessor :device_num
+
+    # @type [String] storage_id
+    attr_accessor :storage_id
+
+    # @type [String] volume
+    attr_accessor :volume
+
+    # Bytes
+    # @type [Number] size
+    attr_accessor :size
+
+    # @type [String] format
+    attr_accessor :format
+
+    # @type [String] options
+    attr_accessor :options
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @device = ''
+      @device_num = 0
+      @storage_id = ''
+      @volume = ''
+      @size = 0
+      @format = ''
+      @options = ''
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'Device'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @device = v
+        when 'DeviceNum'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @device_num = v
+        when 'StorageID'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @storage_id = v
+        when 'Volume'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @volume = v
+        when 'Size'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @size = v
+        when 'Format'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @format = v
+        when 'Options'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @options = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Device'] = @device
+      ret['DeviceNum'] = @device_num
+      unless @storage_id.nil?
+        ret['StorageID'] = @storage_id
+      end
+      unless @volume.nil?
+        ret['Volume'] = @volume
+      end
+      unless @size.nil?
+        ret['Size'] = @size
+      end
+      unless @format.nil?
+        ret['Format'] = @format
+      end
+      unless @options.nil?
+        ret['Options'] = @options
+      end
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/pveparams.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # PVEParams is a typed class wrapper around the underlying Comet Server API data structure.
+  # This type is used in the EngineProps for an "engine1/proxmox" Protected Item. It represents the
+# entire Protected Item configuration. It is expected to be user-configurable.
+  # This type is available in Comet 25.8.0 and later.
+  class PVEParams
+
+    # @type [Boolean] everything
+    attr_accessor :everything
+
+    # @type [Array<Comet::PVEBackupNode>] exclusions
+    attr_accessor :exclusions
+
+    # One of the PVE_BACKUP_METHOD constants
+    # @type [String] method
+    attr_accessor :method
+
+    # Primary node URL + SSH credentials
+    # @type [Comet::SSHConnection] sshconnection
+    attr_accessor :sshconnection
+
+    # @type [Array<Comet::PVEBackupNode>] selections
+    attr_accessor :selections
+
+    # @type [Boolean] use_cbt
+    attr_accessor :use_cbt
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @exclusions = []
+      @method = ''
+      @sshconnection = Comet::SSHConnection.new
+      @selections = []
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'Everything'
+          @everything = v
+        when 'Exclusions'
+          if v.nil?
+            @exclusions = []
+          else
+            @exclusions = Array.new(v.length)
+            v.each_with_index do |v1, i1|
+              @exclusions[i1] = Comet::PVEBackupNode.new
+              @exclusions[i1].from_hash(v1)
+            end
+          end
+        when 'Method'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @method = v
+        when 'SSHConnection'
+          @sshconnection = Comet::SSHConnection.new
+          @sshconnection.from_hash(v)
+        when 'Selections'
+          if v.nil?
+            @selections = []
+          else
+            @selections = Array.new(v.length)
+            v.each_with_index do |v1, i1|
+              @selections[i1] = Comet::PVEBackupNode.new
+              @selections[i1].from_hash(v1)
+            end
+          end
+        when 'UseCBT'
+          @use_cbt = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      unless @everything.nil?
+        ret['Everything'] = @everything
+      end
+      unless @exclusions.nil?
+        ret['Exclusions'] = @exclusions
+      end
+      unless @method.nil?
+        ret['Method'] = @method
+      end
+      unless @sshconnection.nil?
+        ret['SSHConnection'] = @sshconnection
+      end
+      unless @selections.nil?
+        ret['Selections'] = @selections
+      end
+      unless @use_cbt.nil?
+        ret['UseCBT'] = @use_cbt
+      end
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/pvestorage_name.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # PVEStorageName is a typed class wrapper around the underlying Comet Server API data structure.
+  # PVEStorageName contains the name and type of storage configured on a Proxmox Cluster
+  class PVEStorageName
+
+    # @type [String] name
+    attr_accessor :name
+
+    # @type [String] type
+    attr_accessor :type
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @name = ''
+      @type = ''
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'Name'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @name = v
+        when 'Type'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @type = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Name'] = @name
+      ret['Type'] = @type
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/pvevm.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # PVEVM is a typed class wrapper around the underlying Comet Server API data structure.
+  # PVEVM describes a single Proxmox virtual machine or container.
+  class PVEVM
+
+    # @type [String] cpu
+    attr_accessor :cpu
+
+    # @type [Array<Comet::PVEDisk>] disks
+    attr_accessor :disks
+
+    # @type [String] memory
+    attr_accessor :memory
+
+    # @type [String] name
+    attr_accessor :name
+
+    # @type [String] node
+    attr_accessor :node
+
+    # @type [String] ostype
+    attr_accessor :ostype
+
+    # @type [Boolean] running
+    attr_accessor :running
+
+    # @type [String] type
+    attr_accessor :type
+
+    # String type, but always contains an integer value
+    # @type [String] vmid
+    attr_accessor :vmid
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @cpu = ''
+      @disks = []
+      @memory = ''
+      @name = ''
+      @node = ''
+      @ostype = ''
+      @type = ''
+      @vmid = ''
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'CPU'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @cpu = v
+        when 'Disks'
+          if v.nil?
+            @disks = []
+          else
+            @disks = Array.new(v.length)
+            v.each_with_index do |v1, i1|
+              @disks[i1] = Comet::PVEDisk.new
+              @disks[i1].from_hash(v1)
+            end
+          end
+        when 'Memory'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @memory = v
+        when 'Name'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @name = v
+        when 'Node'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @node = v
+        when 'OSType'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @ostype = v
+        when 'Running'
+          @running = v
+        when 'Type'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @type = v
+        when 'VMID'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @vmid = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['CPU'] = @cpu
+      ret['Disks'] = @disks
+      ret['Memory'] = @memory
+      ret['Name'] = @name
+      ret['Node'] = @node
+      ret['OSType'] = @ostype
+      ret['Running'] = @running
+      ret['Type'] = @type
+      ret['VMID'] = @vmid
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/registration_lobby_connection.rb

@@ -36,6 +36,9 @@ module Comet
     # @type [String] ipaddress
     attr_accessor :ipaddress
 
+    # @type [String] host
+    attr_accessor :host
+
     # @type [Number] connection_time
     attr_accessor :connection_time
 
@@ -55,6 +58,7 @@ module Comet
       @reported_platform_version = Comet::OSInfo.new
       @device_time_zone = ''
       @ipaddress = ''
+      @host = ''
       @connection_time = 0
       @unknown_json_fields = {}
     end
@@ -103,6 +107,10 @@ module Comet
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
           @ipaddress = v
+        when 'Host'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @host = v
         when 'ConnectionTime'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -130,6 +138,9 @@ module Comet
       unless @ipaddress.nil?
         ret['IPAddress'] = @ipaddress
       end
+      unless @host.nil?
+        ret['Host'] = @host
+      end
       ret['ConnectionTime'] = @connection_time
       @unknown_json_fields.each do |k, v|
         ret[k] = v

data/lib/comet/models/remote_server_address.rb

@@ -18,15 +18,15 @@ module Comet
     # @type [String] description
     attr_accessor :description
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] remote_address
     attr_accessor :remote_address
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] username
     attr_accessor :username
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] password
     attr_accessor :password
 

data/lib/comet/models/remote_storage_option.rb

@@ -18,15 +18,15 @@ module Comet
     # @type [String] description
     attr_accessor :description
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] remote_address
     attr_accessor :remote_address
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] username
     attr_accessor :username
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] password
     attr_accessor :password
 

data/lib/comet/models/replica_server.rb

@@ -18,15 +18,15 @@ module Comet
     # @type [String] description
     attr_accessor :description
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] remote_address
     attr_accessor :remote_address
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] username
     attr_accessor :username
 
-    # For use with Comet Server (Storage Role / Auth Role)
+    # For use with Comet Server (Storage Gateway / Management Console)
     # @type [String] password
     attr_accessor :password
 

data/lib/comet/models/request_storage_vault_response_message.rb

@@ -22,6 +22,12 @@ module Comet
     # @type [String] destination_id
     attr_accessor :destination_id
 
+    # @type [String] profile_hash
+    attr_accessor :profile_hash
+
+    # @type [Comet::UserProfileConfig] profile
+    attr_accessor :profile
+
     # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
     attr_accessor :unknown_json_fields
 
@@ -33,6 +39,8 @@ module Comet
       @status = 0
       @message = ''
       @destination_id = ''
+      @profile_hash = ''
+      @profile = Comet::UserProfileConfig.new
       @unknown_json_fields = {}
     end
 
@@ -61,6 +69,13 @@ module Comet
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
           @destination_id = v
+        when 'ProfileHash'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @profile_hash = v
+        when 'Profile'
+          @profile = Comet::UserProfileConfig.new
+          @profile.from_hash(v)
         else
           @unknown_json_fields[k] = v
         end
@@ -73,6 +88,8 @@ module Comet
       ret['Status'] = @status
       ret['Message'] = @message
       ret['DestinationID'] = @destination_id
+      ret['ProfileHash'] = @profile_hash
+      ret['Profile'] = @profile
       @unknown_json_fields.each do |k, v|
         ret[k] = v
       end

data/lib/comet/models/restore_job_advanced_options.rb

@@ -117,6 +117,10 @@ module Comet
     # @type [Comet::HyperVRestoreTargetOptions] hyper_vconnection
     attr_accessor :hyper_vconnection
 
+    # For RESTORETYPE_VMHOST
+    # @type [Comet::ProxmoxRestoreTargetOptions] proxmox_connection
+    attr_accessor :proxmox_connection
+
     # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
     attr_accessor :unknown_json_fields
 
@@ -140,6 +144,7 @@ module Comet
       @ms_sql_connection = Comet::MSSQLLoginArgs.new
       @vmware_connection = Comet::VMwareRestoreTargetOptions.new
       @hyper_vconnection = Comet::HyperVRestoreTargetOptions.new
+      @proxmox_connection = Comet::ProxmoxRestoreTargetOptions.new
       @unknown_json_fields = {}
     end
 
@@ -237,6 +242,9 @@ module Comet
         when 'HyperVConnection'
           @hyper_vconnection = Comet::HyperVRestoreTargetOptions.new
           @hyper_vconnection.from_hash(v)
+        when 'ProxmoxConnection'
+          @proxmox_connection = Comet::ProxmoxRestoreTargetOptions.new
+          @proxmox_connection.from_hash(v)
         else
           @unknown_json_fields[k] = v
         end
@@ -278,6 +286,9 @@ module Comet
       unless @hyper_vconnection.nil?
         ret['HyperVConnection'] = @hyper_vconnection
       end
+      unless @proxmox_connection.nil?
+        ret['ProxmoxConnection'] = @proxmox_connection
+      end
       @unknown_json_fields.each do |k, v|
         ret[k] = v
       end