comet_backup_ruby_sdk 2.12.0 → 2.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e58708772fc811caf320d5e37daead88298a9ef573d721055a3970bcf31d3bc
-  data.tar.gz: 70167999c8a0622c11845204871ef6c36679f73b506dc1b260fd0006a71a07ae
+  metadata.gz: 5595c2c9458e40b3d6c0bd1289e9f2c3e42c7b6b76877047dea9a626648808bc
+  data.tar.gz: bec6a1ecdc82849345abf3e1d3a7f58fbfafcc1a46a02e1596e3c9dec16e8e15
 SHA512:
-  metadata.gz: 9c13573fc5191bcba1631a35a0a6b55ab1d8543cbe14c3260eda4991c5432c23a3613d7af77ecee2fe6e789c91b08d949cd61fe924f7521b9ac9778d14b62a07
-  data.tar.gz: 2a59d690d766d51a456d6cbf833287483c58630967f120433d1990afa7eeafb331e027ea7f0ae8b1e3ccd5572e7c3af5b0dd8d5d52a76e2c097c9d9900ca1814
+  metadata.gz: 60823a0d07939472f63562529d631036306fcdfea97b1419cd80798361cb500ae30a297a22286825dd023a699e4aaed3f4ff3138a6b4c7c1dc5d747f89b6d264
+  data.tar.gz: 2dd9f6f226e55b48d8e65217124ac84a502293b64c1cc6a538ece2cd1de5401bd0acc820c31c2f3ba3b0521307875c23f60fc5b570f1d93c1534164221634c38

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # CHANGELOG
 
+## 2023-09-19 v2.14.0
+
+- Based on Comet 23.9.2
+- 'UseObjectLock' for S3 compatible storage settings deprecated. Replaced by 'ObjectLockMode'
+- New Streamable event SEVT_DEVICE_LOBBY_CONNECT and SEVT_DEVICE_LOBBY_DISCONNECT
+- Added 'TOTPCode' to 'InstallCreds' used for device registration.
+- 'GroupedBy' added to 'PSAConfig' for grouping statistics.
+- New APIs
+	- AdminInstallationDispatchDropConnection
+	- AdminInstallationDispatchRegisterDevice
+	- AdminInstallationListActive
+	- AdminJobAbandon
+
+## 2023-08-29 v2.13.0
+
+- Based on Comet 23.8.0
+- Improve documentation of JobStatus constants
+
 ## 2023-08-09 v2.12.0
 
 - Based on Comet 23.6.9

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    comet_backup_ruby_sdk (2.12.0)
+    comet_backup_ruby_sdk (2.14.0)
 
 GEM
   remote: https://rubygems.org/

data/comet_backup_ruby_sdk.gemspec

@@ -12,7 +12,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'comet_backup_ruby_sdk'
-  spec.version       = '2.12.0'
+  spec.version       = '2.14.0'
   spec.authors       = ['Comet Licensing Ltd.']
   spec.email         = ['hello@cometbackup.com']
 

data/lib/comet/comet_server.rb

@@ -2617,6 +2617,121 @@ module Comet
       ret
     end
 
+    # AdminInstallationDispatchDropConnection
+    #
+    # Instruct a live connected device to disconnect.
+    # The device will terminate its live-connection process and will not reconnect.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] device_id The live connection Device GUID
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_installation_dispatch_drop_connection(device_id)
+      submit_params = {}
+      raise TypeError, "'device_id' expected String, got #{device_id.class}" unless device_id.is_a? String
+
+      submit_params['DeviceID'] = device_id
+
+      body = perform_request('api/v1/admin/installation/dispatch/drop-connection', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminInstallationDispatchRegisterDevice
+    #
+    # Instruct an unregistered device to authenticate with a given user.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] device_id The live connection Device GUID
+    # @param [String] target_user Selected account username
+    # @param [String] target_password Selected account password
+    # @param [String] target_totpcode (Optional) Selected account TOTP code
+    # @return [String]
+    def admin_installation_dispatch_register_device(device_id, target_user, target_password, target_totpcode = nil)
+      submit_params = {}
+      raise TypeError, "'device_id' expected String, got #{device_id.class}" unless device_id.is_a? String
+
+      submit_params['DeviceID'] = device_id
+      raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
+
+      submit_params['TargetUser'] = target_user
+      raise TypeError, "'target_password' expected String, got #{target_password.class}" unless target_password.is_a? String
+
+      submit_params['TargetPassword'] = target_password
+      unless target_totpcode.nil?
+        raise TypeError, "'target_totpcode' expected String, got #{target_totpcode.class}" unless target_totpcode.is_a? String
+
+        submit_params['TargetTOTPCode'] = target_totpcode
+      end
+
+      body = perform_request('api/v1/admin/installation/dispatch/register-device', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      raise TypeError, "'json_body' expected String, got #{json_body.class}" unless json_body.is_a? String
+
+      ret = json_body
+      ret
+    end
+
+    # AdminInstallationListActive
+    #
+    # List live connected devices in lobby mode.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @return [Hash{String => Comet::RegistrationLobbyConnection}]
+    def admin_installation_list_active
+      body = perform_request('api/v1/admin/installation/list-active')
+      json_body = JSON.parse body
+      check_status json_body
+      ret = {}
+      if json_body.nil?
+        ret = {}
+      else
+        json_body.each do |k, v|
+          ret[k] = Comet::RegistrationLobbyConnection.new
+          ret[k].from_hash(v)
+        end
+      end
+      ret
+    end
+
+    # AdminJobAbandon
+    #
+    # Mark a running job as abandoned.
+    # This will change the status of a running job to abandoned.
+    # This is intended to be used on jobs which are definitely no longer running but are stuck in the running state; it will not attempt to cancel the job. If the job is detected to still be running after being marked as abandoned, it will be revived.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_user Username
+    # @param [String] job_id Job ID
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_job_abandon(target_user, job_id)
+      submit_params = {}
+      raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
+
+      submit_params['TargetUser'] = target_user
+      raise TypeError, "'job_id' expected String, got #{job_id.class}" unless job_id.is_a? String
+
+      submit_params['JobID'] = job_id
+
+      body = perform_request('api/v1/admin/job/abandon', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminJobCancel
     #
     # Cancel a running job.

data/lib/comet/definitions.rb

@@ -7,13 +7,13 @@
 
 module Comet
 
-  APPLICATION_VERSION = '23.6.9'
+  APPLICATION_VERSION = '23.9.2'
 
   APPLICATION_VERSION_MAJOR = 23
 
-  APPLICATION_VERSION_MINOR = 6
+  APPLICATION_VERSION_MINOR = 9
 
-  APPLICATION_VERSION_REVISION = 9
+  APPLICATION_VERSION_REVISION = 2
 
   # AutoRetentionLevel: The system will automatically choose how often to run an automatic Retention Pass after each backup job.
   BACKUPJOBAUTORETENTION_AUTOMATIC = 0
@@ -264,7 +264,7 @@ module Comet
   # JobStatus: If the BackupJobDetail.Status field is a 5xxx code, the job has stopped for a successful reason.
   JOB_STATUS_STOP_SUCCESS__MIN = 5000
 
-  # JobStatus
+  # JobStatus: The job is complete and was successful.
   JOB_STATUS_STOP_SUCCESS = 5000
 
   # JobStatus
@@ -276,10 +276,10 @@ module Comet
   # JobStatus: Unused
   JOB_STATUS_RUNNING_INDETERMINATE = 6000
 
-  # JobStatus
+  # JobStatus: The last information the server received from the device is that the job is currently running.
   JOB_STATUS_RUNNING_ACTIVE = 6001
 
-  # JobStatus: A backup job that was marked as stopped or abandoned, but has somehow continued to run
+  # JobStatus: The job was thought to have been in an Abandoned state but updated the Comet Server with a running status.
   JOB_STATUS_RUNNING_REVIVED = 6002
 
   # JobStatus
@@ -291,25 +291,25 @@ module Comet
   # JobStatus
   JOB_STATUS_FAILED_TIMEOUT = 7000
 
-  # JobStatus
+  # JobStatus: The job is complete but there was a problem that may have resulted in issues with the expected result.
   JOB_STATUS_FAILED_WARNING = 7001
 
-  # JobStatus
+  # JobStatus: There was an error during the job and it did not fully complete.
   JOB_STATUS_FAILED_ERROR = 7002
 
-  # JobStatus
+  # JobStatus: During a backup job either the "All protected items" quota or "Storage Vault" quota was exceeded.
   JOB_STATUS_FAILED_QUOTA = 7003
 
-  # JobStatus
+  # JobStatus: The job did not start at its scheduled time.
   JOB_STATUS_FAILED_SCHEDULEMISSED = 7004
 
-  # JobStatus
+  # JobStatus: The job was cancelled manually, a device shutdown was detected, or the backup time limit was reached.
   JOB_STATUS_FAILED_CANCELLED = 7005
 
-  # JobStatus
+  # JobStatus: The backup job was skipped as there was already a backup running and the "Skip if already running" option was enabled.
   JOB_STATUS_FAILED_SKIPALREADYRUNNING = 7006
 
-  # JobStatus
+  # JobStatus: The job has stopped unexpectedly or has been manually marked as abandoned by an admin.
   JOB_STATUS_FAILED_ABANDONED = 7007
 
   # JobStatus
@@ -361,6 +361,12 @@ module Comet
   # MSSQLRestoreOpt
   MSSQL_RESTORE_NORECOVERY = 'NO_RECOVERY'
 
+  OBJECT_LOCK_LEGACY = 0
+
+  OBJECT_LOCK_ON = 1
+
+  OBJECT_LOCK_OFF = 2
+
   OFFICE365_REGION_PUBLIC = 'GlobalPublicCloud'
 
   OFFICE365_REGION_CHINA = 'ChinaCloud'
@@ -829,6 +835,12 @@ module Comet
   # StreamableEventType: Device live connection ended
   SEVT_DEVICE_LIVE_DISCONNECT = 4703
 
+  # StreamableEventType: Device connected to registration lobby
+  SEVT_DEVICE_LOBBY_CONNECT = 4704
+
+  # StreamableEventType: Device disconnected from registration lobby
+  SEVT_DEVICE_LOBBY_DISCONNECT = 4705
+
   # StreamableEventType
   SEVT__MAX = 4999
 
@@ -958,6 +970,8 @@ module Comet
   # UpdateStatus: The device has successfully updated to the target version.
   UPDATESTATUS_UPDATE_CONFIRMED = 5
 
+  USERNAME_MAX_LENGTH = 255
+
   # If an API response returns in failure, but it includes this value in the CometAPIResponseMessage->Message parameter, it indicates that the specified Device ID was invalid or not found.
   UNKNOWN_DEVICE_ERROR = 'ERR_UNKNOWN_DEVICE'
 

data/lib/comet/models/amazon_awsvirtual_storage_role_settings.rb

@@ -21,8 +21,11 @@ module Comet
     # @type [String] secret_key
     attr_accessor :secret_key
 
-    # @type [Boolean] use_object_lock
-    attr_accessor :use_object_lock
+    # @type [Boolean] use_object_lock__legacy__do_not_use
+    attr_accessor :use_object_lock__legacy__do_not_use
+
+    # @type [Number] object_lock_mode
+    attr_accessor :object_lock_mode
 
     # @type [Number] object_lock_days
     attr_accessor :object_lock_days
@@ -41,6 +44,7 @@ module Comet
       @master_bucket = ''
       @access_key = ''
       @secret_key = ''
+      @object_lock_mode = 0
       @object_lock_days = 0
       @unknown_json_fields = {}
     end
@@ -71,7 +75,11 @@ module Comet
 
           @secret_key = v
         when 'UseObjectLock'
-          @use_object_lock = v
+          @use_object_lock__legacy__do_not_use = v
+        when 'ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @object_lock_mode = v
         when 'ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -90,7 +98,8 @@ module Comet
       ret['MasterBucket'] = @master_bucket
       ret['AccessKey'] = @access_key
       ret['SecretKey'] = @secret_key
-      ret['UseObjectLock'] = @use_object_lock
+      ret['UseObjectLock'] = @use_object_lock__legacy__do_not_use
+      ret['ObjectLockMode'] = @object_lock_mode
       ret['ObjectLockDays'] = @object_lock_days
       ret['RemoveDeleted'] = @remove_deleted
       @unknown_json_fields.each do |k, v|

data/lib/comet/models/destination_config.rb

@@ -77,6 +77,9 @@ module Comet
     # @type [Boolean] s3remove_deleted
     attr_accessor :s3remove_deleted
 
+    # @type [Number] s3object_lock_mode
+    attr_accessor :s3object_lock_mode
+
     # @type [Number] s3object_lock_days
     attr_accessor :s3object_lock_days
 
@@ -264,6 +267,7 @@ module Comet
       @s3bucket_name = ''
       @s3subdir = ''
       @s3custom_region = ''
+      @s3object_lock_mode = 0
       @s3object_lock_days = 0
       @sftpserver = ''
       @sftpusername = ''
@@ -406,6 +410,10 @@ module Comet
           @s3uses_v2signing = v
         when 'S3RemoveDeleted'
           @s3remove_deleted = v
+        when 'S3ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @s3object_lock_mode = v
         when 'S3ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -586,6 +594,7 @@ module Comet
       ret['S3CustomRegion'] = @s3custom_region
       ret['S3UsesV2Signing'] = @s3uses_v2signing
       ret['S3RemoveDeleted'] = @s3remove_deleted
+      ret['S3ObjectLockMode'] = @s3object_lock_mode
       ret['S3ObjectLockDays'] = @s3object_lock_days
       ret['SFTPServer'] = @sftpserver
       ret['SFTPUsername'] = @sftpusername

data/lib/comet/models/destination_location.rb

@@ -57,6 +57,9 @@ module Comet
     # @type [Boolean] s3remove_deleted
     attr_accessor :s3remove_deleted
 
+    # @type [Number] s3object_lock_mode
+    attr_accessor :s3object_lock_mode
+
     # @type [Number] s3object_lock_days
     attr_accessor :s3object_lock_days
 
@@ -205,6 +208,7 @@ module Comet
       @s3bucket_name = ''
       @s3subdir = ''
       @s3custom_region = ''
+      @s3object_lock_mode = 0
       @s3object_lock_days = 0
       @sftpserver = ''
       @sftpusername = ''
@@ -296,6 +300,10 @@ module Comet
           @s3uses_v2signing = v
         when 'S3RemoveDeleted'
           @s3remove_deleted = v
+        when 'S3ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @s3object_lock_mode = v
         when 'S3ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -444,6 +452,7 @@ module Comet
       ret['S3CustomRegion'] = @s3custom_region
       ret['S3UsesV2Signing'] = @s3uses_v2signing
       ret['S3RemoveDeleted'] = @s3remove_deleted
+      ret['S3ObjectLockMode'] = @s3object_lock_mode
       ret['S3ObjectLockDays'] = @s3object_lock_days
       ret['SFTPServer'] = @sftpserver
       ret['SFTPUsername'] = @sftpusername

data/lib/comet/models/install_creds.rb

@@ -18,6 +18,9 @@ module Comet
     # @type [String] password
     attr_accessor :password
 
+    # @type [String] totpcode
+    attr_accessor :totpcode
+
     # @type [String] server
     attr_accessor :server
 
@@ -34,6 +37,7 @@ module Comet
     def clear
       @username = ''
       @password = ''
+      @totpcode = ''
       @server = ''
       @unknown_json_fields = {}
     end
@@ -59,6 +63,10 @@ module Comet
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
           @password = v
+        when 'TOTPCode'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @totpcode = v
         when 'Server'
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
@@ -76,6 +84,7 @@ module Comet
       ret = {}
       ret['Username'] = @username
       ret['Password'] = @password
+      ret['TOTPCode'] = @totpcode
       ret['Server'] = @server
       ret['AutoLogin'] = @auto_login
       @unknown_json_fields.each do |k, v|

data/lib/comet/models/psaconfig.rb

@@ -31,6 +31,9 @@ module Comet
     # @type [String] url
     attr_accessor :url
 
+    # @type [Comet::PSAGroupedBy] grouped_by
+    attr_accessor :grouped_by
+
     # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
     attr_accessor :unknown_json_fields
 
@@ -43,6 +46,7 @@ module Comet
       @partner_key = ''
       @type = 0
       @url = ''
+      @grouped_by = Comet::PSAGroupedBy.new
       @unknown_json_fields = {}
     end
 
@@ -84,6 +88,9 @@ module Comet
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
           @url = v
+        when 'GroupedBy'
+          @grouped_by = Comet::PSAGroupedBy.new
+          @grouped_by.from_hash(v)
         else
           @unknown_json_fields[k] = v
         end
@@ -102,6 +109,7 @@ module Comet
       end
       ret['Type'] = @type
       ret['URL'] = @url
+      ret['GroupedBy'] = @grouped_by
       @unknown_json_fields.each do |k, v|
         ret[k] = v
       end

data/lib/comet/models/psagrouped_by.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2023 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # PSAGroupedBy is a typed class wrapper around the underlying Comet Server API data structure.
+  class PSAGroupedBy
+
+    # @type [Boolean] users
+    attr_accessor :users
+
+    # @type [Boolean] tenants
+    attr_accessor :tenants
+
+    # @type [Boolean] account_name
+    attr_accessor :account_name
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @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 'Users'
+          @users = v
+        when 'Tenants'
+          @tenants = v
+        when 'AccountName'
+          @account_name = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Users'] = @users
+      ret['Tenants'] = @tenants
+      ret['AccountName'] = @account_name
+      @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

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2023 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # RegistrationLobbyConnection is a typed class wrapper around the underlying Comet Server API data structure.
+  class RegistrationLobbyConnection
+
+    # @type [String] device_id
+    attr_accessor :device_id
+
+    # @type [String] organization_id
+    attr_accessor :organization_id
+
+    # @type [String] friendly_name
+    attr_accessor :friendly_name
+
+    # @type [String] reported_version
+    attr_accessor :reported_version
+
+    # @type [String] reported_platform
+    attr_accessor :reported_platform
+
+    # @type [Comet::OSInfo] reported_platform_version
+    attr_accessor :reported_platform_version
+
+    # @type [String] device_time_zone
+    attr_accessor :device_time_zone
+
+    # @type [String] ipaddress
+    attr_accessor :ipaddress
+
+    # @type [Number] connection_time
+    attr_accessor :connection_time
+
+    # @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_id = ''
+      @organization_id = ''
+      @friendly_name = ''
+      @reported_version = ''
+      @reported_platform = ''
+      @reported_platform_version = Comet::OSInfo.new
+      @device_time_zone = ''
+      @ipaddress = ''
+      @connection_time = 0
+      @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 'DeviceID'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @device_id = v
+        when 'OrganizationID'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @organization_id = v
+        when 'FriendlyName'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @friendly_name = v
+        when 'ReportedVersion'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @reported_version = v
+        when 'ReportedPlatform'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @reported_platform = v
+        when 'ReportedPlatformVersion'
+          @reported_platform_version = Comet::OSInfo.new
+          @reported_platform_version.from_hash(v)
+        when 'DeviceTimeZone'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @device_time_zone = v
+        when 'IPAddress'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @ipaddress = v
+        when 'ConnectionTime'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @connection_time = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['DeviceID'] = @device_id
+      ret['OrganizationID'] = @organization_id
+      ret['FriendlyName'] = @friendly_name
+      ret['ReportedVersion'] = @reported_version
+      ret['ReportedPlatform'] = @reported_platform
+      unless @reported_platform_version.nil?
+        ret['ReportedPlatformVersion'] = @reported_platform_version
+      end
+      unless @device_time_zone.nil?
+        ret['DeviceTimeZone'] = @device_time_zone
+      end
+      unless @ipaddress.nil?
+        ret['IPAddress'] = @ipaddress
+      end
+      ret['ConnectionTime'] = @connection_time
+      @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/s3destination_location.rb

@@ -40,6 +40,9 @@ module Comet
     # @type [Boolean] s3remove_deleted
     attr_accessor :s3remove_deleted
 
+    # @type [Number] s3object_lock_mode
+    attr_accessor :s3object_lock_mode
+
     # @type [Number] s3object_lock_days
     attr_accessor :s3object_lock_days
 
@@ -57,6 +60,7 @@ module Comet
       @s3bucket_name = ''
       @s3subdir = ''
       @s3custom_region = ''
+      @s3object_lock_mode = 0
       @s3object_lock_days = 0
       @unknown_json_fields = {}
     end
@@ -104,6 +108,10 @@ module Comet
           @s3uses_v2signing = v
         when 'S3RemoveDeleted'
           @s3remove_deleted = v
+        when 'S3ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @s3object_lock_mode = v
         when 'S3ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -126,6 +134,7 @@ module Comet
       ret['S3CustomRegion'] = @s3custom_region
       ret['S3UsesV2Signing'] = @s3uses_v2signing
       ret['S3RemoveDeleted'] = @s3remove_deleted
+      ret['S3ObjectLockMode'] = @s3object_lock_mode
       ret['S3ObjectLockDays'] = @s3object_lock_days
       @unknown_json_fields.each do |k, v|
         ret[k] = v

data/lib/comet/models/s3generic_virtual_storage_role.rb

@@ -27,8 +27,11 @@ module Comet
     # @type [String] secret_key
     attr_accessor :secret_key
 
-    # @type [Boolean] use_object_lock
-    attr_accessor :use_object_lock
+    # @type [Boolean] use_object_lock__legacy__do_not_use
+    attr_accessor :use_object_lock__legacy__do_not_use
+
+    # @type [Number] object_lock_mode
+    attr_accessor :object_lock_mode
 
     # @type [Number] object_lock_days
     attr_accessor :object_lock_days
@@ -49,6 +52,7 @@ module Comet
       @master_bucket = ''
       @access_key = ''
       @secret_key = ''
+      @object_lock_mode = 0
       @object_lock_days = 0
       @unknown_json_fields = {}
     end
@@ -87,7 +91,11 @@ module Comet
 
           @secret_key = v
         when 'UseObjectLock'
-          @use_object_lock = v
+          @use_object_lock__legacy__do_not_use = v
+        when 'ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @object_lock_mode = v
         when 'ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -108,7 +116,8 @@ module Comet
       ret['MasterBucket'] = @master_bucket
       ret['AccessKey'] = @access_key
       ret['SecretKey'] = @secret_key
-      ret['UseObjectLock'] = @use_object_lock
+      ret['UseObjectLock'] = @use_object_lock__legacy__do_not_use
+      ret['ObjectLockMode'] = @object_lock_mode
       ret['ObjectLockDays'] = @object_lock_days
       ret['RemoveDeleted'] = @remove_deleted
       @unknown_json_fields.each do |k, v|

data/lib/comet/models/wasabi_virtual_storage_role_settings.rb

@@ -21,8 +21,11 @@ module Comet
     # @type [String] secret_key
     attr_accessor :secret_key
 
-    # @type [Boolean] use_object_lock
-    attr_accessor :use_object_lock
+    # @type [Boolean] use_object_lock__legacy__do_not_use
+    attr_accessor :use_object_lock__legacy__do_not_use
+
+    # @type [Number] object_lock_mode
+    attr_accessor :object_lock_mode
 
     # @type [Number] object_lock_days
     attr_accessor :object_lock_days
@@ -41,6 +44,7 @@ module Comet
       @master_bucket = ''
       @access_key = ''
       @secret_key = ''
+      @object_lock_mode = 0
       @object_lock_days = 0
       @unknown_json_fields = {}
     end
@@ -71,7 +75,11 @@ module Comet
 
           @secret_key = v
         when 'UseObjectLock'
-          @use_object_lock = v
+          @use_object_lock__legacy__do_not_use = v
+        when 'ObjectLockMode'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @object_lock_mode = v
         when 'ObjectLockDays'
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
@@ -90,7 +98,8 @@ module Comet
       ret['MasterBucket'] = @master_bucket
       ret['AccessKey'] = @access_key
       ret['SecretKey'] = @secret_key
-      ret['UseObjectLock'] = @use_object_lock
+      ret['UseObjectLock'] = @use_object_lock__legacy__do_not_use
+      ret['ObjectLockMode'] = @object_lock_mode
       ret['ObjectLockDays'] = @object_lock_days
       ret['RemoveDeleted'] = @remove_deleted
       @unknown_json_fields.each do |k, v|

data/lib/comet_backup_ruby_sdk.rb

@@ -116,11 +116,13 @@ require_relative 'comet/models/partition'
 require_relative 'comet/models/private_branding_properties'
 require_relative 'comet/models/protected_item_engine_type_policy'
 require_relative 'comet/models/psaconfig'
+require_relative 'comet/models/psagrouped_by'
 require_relative 'comet/models/public_branding_properties'
 require_relative 'comet/models/ratelimit_options'
 require_relative 'comet/models/ratelimit_rule'
 require_relative 'comet/models/register_office_application_begin_response'
 require_relative 'comet/models/register_office_application_check_response'
+require_relative 'comet/models/registration_lobby_connection'
 require_relative 'comet/models/remote_server_address'
 require_relative 'comet/models/remote_storage_option'
 require_relative 'comet/models/replica_server'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: comet_backup_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 2.12.0
+  version: 2.14.0
 platform: ruby
 authors:
 - Comet Licensing Ltd.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-09 00:00:00.000000000 Z
+date: 2023-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -194,11 +194,13 @@ files:
 - lib/comet/models/private_branding_properties.rb
 - lib/comet/models/protected_item_engine_type_policy.rb
 - lib/comet/models/psaconfig.rb
+- lib/comet/models/psagrouped_by.rb
 - lib/comet/models/public_branding_properties.rb
 - lib/comet/models/ratelimit_options.rb
 - lib/comet/models/ratelimit_rule.rb
 - lib/comet/models/register_office_application_begin_response.rb
 - lib/comet/models/register_office_application_check_response.rb
+- lib/comet/models/registration_lobby_connection.rb
 - lib/comet/models/remote_server_address.rb
 - lib/comet/models/remote_storage_option.rb
 - lib/comet/models/replica_server.rb