comet_backup_ruby_sdk 2.40.0 → 2.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8de6d34a1a34e2fef7d5b970bfc33cc451106ca28c7a292060ebbee262bb7ed3
-  data.tar.gz: 9e0bde4efe6c21153d91881efbf6f8b74ea7b4881a21ff85cda2f7675297e516
+  metadata.gz: b1ce12d259b4709b8f945a3ab03c5aaa3affa2bf686d8db13a579efa734352ca
+  data.tar.gz: dccfbf9c48da859196a0ea45fd546e48869c696860b19b9e0e17275a9ad00ff1
 SHA512:
-  metadata.gz: c47886f036adebb1cd44c44e5bd371cefe470e3cd569925d451f0a8c5d4983a97d70db58afc6ec89d82cab2e34ce6cb2ac75a68394ac2440bd94a98bb47609bf
-  data.tar.gz: 2ce781adab00183ab1533cbf0f207cb976be7f590df60b2147fc54384670abe6bd6047067d78047f407bcc1137fb10eeb135934a4f47027aa40bddd5d2ea2e78
+  metadata.gz: ca9afca76f9b80e1f66e22c05bacd2615be2f644f8b3d6db2caf5eb8f25736bb2e4afa73648dd6eaae0985ec2a92626edbba4a523edc43a410733ae7c2ab7f17
+  data.tar.gz: 9e6c3ce78d176e8c37966a00e2a33e835da5ed4e32295223d8e4fb9a07530d4a593288732b2a2c714690948ea3a3c4d5f7bf13455abce00ed2f791766e0cd825

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 2025-08-15 v2.42.0
+
+- Based on Comet 25.6.8
+- Add support for Proxmox
+- Add profile hash to some API endpoints
+
+## 2025-02-17 v2.41.0
+Update to 24.12.5
+
+- Based on Comet 24.12.5
+
 ## 2025-01-29 v2.40.0
 
 - Based on Comet 24.12.4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    comet_backup_ruby_sdk (2.40.0)
+    comet_backup_ruby_sdk (2.42.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.40.0'
+  spec.version       = '2.42.0'
   spec.authors       = ['Comet Licensing Ltd.']
   spec.email         = ['hello@cometbackup.com']
 

data/lib/comet/comet_server.rb

@@ -1143,6 +1143,37 @@ module Comet
       ret
     end
 
+    # AdminDispatcherBrowseVirtualMachines
+    #
+    # Browse virtual machines in target snapshot.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [String] destination_id The Storage Vault GUID
+    # @param [String] snapshot_id Snapshot to search
+    # @return [Comet::DispatcherListSnapshotVirtualMachinesResponse]
+    def admin_dispatcher_browse_virtual_machines(target_id, destination_id, snapshot_id)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'destination_id' expected String, got #{destination_id.class}" unless destination_id.is_a? String
+
+      submit_params['DestinationID'] = destination_id
+      raise TypeError, "'snapshot_id' expected String, got #{snapshot_id.class}" unless snapshot_id.is_a? String
+
+      submit_params['SnapshotID'] = snapshot_id
+
+      body = perform_request('api/v1/admin/dispatcher/browse-virtual-machines', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::DispatcherListSnapshotVirtualMachinesResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherDeepverifyStorageVault
     #
     # Instruct a live connected device to deeply verify Storage Vault content.
@@ -1718,6 +1749,87 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRequestBrowseProxmox
+    #
+    # Request a list of Proxmox virtual machines and containers.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::ProxmoxConnection] credentials The Proxmox connection settings
+    # @return [Comet::BrowseProxmoxResponse]
+    def admin_dispatcher_request_browse_proxmox(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::ProxmoxConnection, got #{credentials.class}" unless credentials.is_a? Comet::ProxmoxConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseProxmoxNodes
+    #
+    # Request a list of Proxmox nodes.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::SSHConnection] credentials The SSH connection settings
+    # @return [Comet::BrowseProxmoxNodesResponse]
+    def admin_dispatcher_request_browse_proxmox_nodes(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::SSHConnection, got #{credentials.class}" unless credentials.is_a? Comet::SSHConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox/nodes', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxNodesResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseProxmoxStorage
+    #
+    # Request a list of configured Proxmox storage.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::SSHConnection] credentials The SSH connection settings
+    # @return [Comet::BrowseProxmoxStorageResponse]
+    def admin_dispatcher_request_browse_proxmox_storage(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::SSHConnection, got #{credentials.class}" unless credentials.is_a? Comet::SSHConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox/storage', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxStorageResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRequestBrowseVmware
     #
     # Request a list of VMware vSphere virtual machines.
@@ -1746,6 +1858,130 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRequestBrowseVmwareDatacenters
+    #
+    # Request a list of VMware vSphere Datacenters on a VMware vSphere connection.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::VMwareConnection] credentials The VMware vSphere connection settings
+    # @return [Comet::BrowseVMwareDatacentersResponse]
+    def admin_dispatcher_request_browse_vmware_datacenters(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::VMwareConnection, got #{credentials.class}" unless credentials.is_a? Comet::VMwareConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-vmware/datacenters', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseVMwareDatacentersResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseVmwareDatastores
+    #
+    # Request a list of VMware vSphere Datastores on a VMware vSphere connection, for a specified VMware Datacenter.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::VMwareConnection] credentials The VMware vSphere connection settings
+    # @param [String] filter The name of the target VMware Datacenter
+    # @return [Comet::BrowseVMwareDatastoresResponse]
+    def admin_dispatcher_request_browse_vmware_datastores(target_id, credentials, filter)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::VMwareConnection, got #{credentials.class}" unless credentials.is_a? Comet::VMwareConnection
+
+      submit_params['Credentials'] = credentials.to_json
+      raise TypeError, "'filter' expected String, got #{filter.class}" unless filter.is_a? String
+
+      submit_params['Filter'] = filter
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-vmware/datastores', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseVMwareDatastoresResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseVmwareHosts
+    #
+    # Request a list of VMware vSphere Hosts on a VMware vSphere connection, for a specified VMware Datacenter.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::VMwareConnection] credentials The VMware vSphere connection settings
+    # @param [String] filter The name of the target VMware Datacenter
+    # @return [Comet::BrowseVMwareHostsResponse]
+    def admin_dispatcher_request_browse_vmware_hosts(target_id, credentials, filter)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::VMwareConnection, got #{credentials.class}" unless credentials.is_a? Comet::VMwareConnection
+
+      submit_params['Credentials'] = credentials.to_json
+      raise TypeError, "'filter' expected String, got #{filter.class}" unless filter.is_a? String
+
+      submit_params['Filter'] = filter
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-vmware/hosts', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseVMwareHostsResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseVmwareNetworks
+    #
+    # Request a list of VMware vSphere Networks on a VMware vSphere connection, for a specified VMware Datacenter.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::VMwareConnection] credentials The VMware vSphere connection settings
+    # @param [String] filter The name of the target VMware Datacenter
+    # @return [Comet::BrowseVMwareNetworksResponse]
+    def admin_dispatcher_request_browse_vmware_networks(target_id, credentials, filter)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::VMwareConnection, got #{credentials.class}" unless credentials.is_a? Comet::VMwareConnection
+
+      submit_params['Credentials'] = credentials.to_json
+      raise TypeError, "'filter' expected String, got #{filter.class}" unless filter.is_a? String
+
+      submit_params['Filter'] = filter
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-vmware/networks', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseVMwareNetworksResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRequestBrowseVssAaw
     #
     # Request a list of installed VSS Writers (Application-Aware Writers) from a live connected device.
@@ -2258,8 +2494,9 @@ module Comet
     #
     # @param [String] target_id The live connection GUID
     # @param [String] destination The Storage Vault GUID
+    # @param [Boolean] allow_unsafe (Optional) Allow legacy Storage Vault unlocking, which is unsafe in some cases.
     # @return [Comet::CometAPIResponseMessage]
-    def admin_dispatcher_unlock(target_id, destination)
+    def admin_dispatcher_unlock(target_id, destination, allow_unsafe = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
 
@@ -2267,6 +2504,9 @@ module Comet
       raise TypeError, "'destination' expected String, got #{destination.class}" unless destination.is_a? String
 
       submit_params['Destination'] = destination
+      unless allow_unsafe.nil?
+        submit_params['AllowUnsafe'] = (allow_unsafe ? 1 : 0)
+      end
 
       body = perform_request('api/v1/admin/dispatcher/unlock', submit_params)
       json_body = JSON.parse body
@@ -3976,8 +4216,9 @@ module Comet
     # @param [String] policy_id The policy ID to update or create
     # @param [Comet::GroupPolicy] policy The policy data
     # @param [String] check_policy_hash (Optional) An atomic verification hash as supplied by the AdminPoliciesGet API
+    # @param [Comet::PolicyOptions] options (Optional) An array of PolicySourceID that will be explicitly deleted.
     # @return [Comet::CometAPIResponseMessage]
-    def admin_policies_set(policy_id, policy, check_policy_hash = nil)
+    def admin_policies_set(policy_id, policy, check_policy_hash = nil, options = nil)
       submit_params = {}
       raise TypeError, "'policy_id' expected String, got #{policy_id.class}" unless policy_id.is_a? String
 
@@ -3990,6 +4231,11 @@ module Comet
 
         submit_params['CheckPolicyHash'] = check_policy_hash
       end
+      unless options.nil?
+        raise TypeError, "'options' expected Comet::PolicyOptions, got #{options.class}" unless options.is_a? Comet::PolicyOptions
+
+        submit_params['Options'] = options.to_json
+      end
 
       body = perform_request('api/v1/admin/policies/set', submit_params)
       json_body = JSON.parse body
@@ -4070,8 +4316,9 @@ module Comet
     # @param [String] storage_provider ID for the storage template destination
     # @param [String] self_address (Optional) The external URL for this server. Used to resolve conflicts
     # @param [String] device_id (Optional) The ID of the device to be added as a associated device of the Storage Vault
+    # @param [String] profile_hash (Optional) The profile hash of the user profile
     # @return [Comet::RequestStorageVaultResponseMessage]
-    def admin_request_storage_vault(target_user, storage_provider, self_address = nil, device_id = nil)
+    def admin_request_storage_vault(target_user, storage_provider, self_address = nil, device_id = nil, profile_hash = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
 
@@ -4091,6 +4338,11 @@ module Comet
 
         submit_params['DeviceID'] = device_id
       end
+      unless profile_hash.nil?
+        raise TypeError, "'profile_hash' expected String, got #{profile_hash.class}" unless profile_hash.is_a? String
+
+        submit_params['ProfileHash'] = profile_hash
+      end
 
       body = perform_request('api/v1/admin/request-storage-vault', submit_params)
       json_body = JSON.parse body
@@ -4251,8 +4503,9 @@ module Comet
     # @param [String] target_user Selected account username
     # @param [Comet::UserProfileConfig] profile_data Modified user profile
     # @param [String] require_hash Previous hash parameter
-    # @return [Comet::CometAPIResponseMessage]
-    def admin_set_user_profile_hash(target_user, profile_data, require_hash)
+    # @param [Comet::AdminOptions] admin_options (Optional) Instructions for modifying user profile
+    # @return [Comet::GetProfileAndHashResponseMessage]
+    def admin_set_user_profile_hash(target_user, profile_data, require_hash, admin_options = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
 
@@ -4263,11 +4516,16 @@ module Comet
       raise TypeError, "'require_hash' expected String, got #{require_hash.class}" unless require_hash.is_a? String
 
       submit_params['RequireHash'] = require_hash
+      unless admin_options.nil?
+        raise TypeError, "'admin_options' expected Comet::AdminOptions, got #{admin_options.class}" unless admin_options.is_a? Comet::AdminOptions
+
+        submit_params['AdminOptions'] = admin_options.to_json
+      end
 
       body = perform_request('api/v1/admin/set-user-profile-hash', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::GetProfileAndHashResponseMessage.new
       ret.from_hash(json_body)
       ret
     end

data/lib/comet/definitions.rb

@@ -7,13 +7,13 @@
 
 module Comet
 
-  APPLICATION_VERSION = '24.12.4'
+  APPLICATION_VERSION = '25.6.8'
 
-  APPLICATION_VERSION_MAJOR = 24
+  APPLICATION_VERSION_MAJOR = 25
 
-  APPLICATION_VERSION_MINOR = 12
+  APPLICATION_VERSION_MINOR = 6
 
-  APPLICATION_VERSION_REVISION = 4
+  APPLICATION_VERSION_REVISION = 8
 
   # AutoRetentionLevel: The system will automatically choose how often to run an automatic Retention Pass after each backup job.
   BACKUPJOBAUTORETENTION_AUTOMATIC = 0
@@ -105,6 +105,9 @@ module Comet
 
   DESTINATIONTYPE___INVALID = 0
 
+  # Storage type that is applied when Storage Gateway fails to launch correctly
+  DESTINATIONTYPE_ERROR = 1
+
   # S3-compatible, or a specific S3 service such as AWS S3, Wasabi, or iDrive e2
   DESTINATIONTYPE_S3 = 1000
 
@@ -236,6 +239,9 @@ module Comet
   # VMware
   ENGINE_BUILTIN_VMWARE = 'engine1/vmware'
 
+  # Proxmox (PVE)
+  ENGINE_BUILTIN_PROXMOX = 'engine1/proxmox'
+
   # FtpsModeType: Use plain FTP, do not use FTPS.
   FTPS_MODE_PLAINTEXT = 0
 
@@ -433,6 +439,8 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
 
   OFFICE365_REGION_US_DOD = 'USGovtGccDoDCloud'
 
+  OFFICE365_REGION_PUBLIC_TEST = 'GlobalPublicCloudTest'
+
   # ExtraFileExclusionOSRestriction: Applies to any device
   OS_ANY = 0
 
@@ -466,6 +474,10 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # OidcProvider
   PROVIDER_DASHBOARD = 'dashboard'
 
+  PROXMOX_TYPE_VM = 'qemu'
+
+  PROXMOX_TYPE_CONTAINER = 'lxc'
+
   # PSAType
   PSA_TYPE_GENERIC = 0
 
@@ -475,6 +487,14 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # PSAType
   PSA_TYPE_SYNCRO = 2
 
+  PVE_BACKUP_METHOD_STOP = 'stop'
+
+  PVE_BACKUP_METHOD_SUSPEND = 'suspend'
+
+  PVE_BACKUP_METHOD_SNAPSHOT = 'snapshot'
+
+  PVE_BACKUP_METHOD_DEFAULT = PVE_BACKUP_METHOD_SNAPSHOT
+
   RELEASE_CODENAME = 'Voyager'
 
   # RemoteServerType: Comet Server
@@ -597,6 +617,10 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # RestoreType: Restore disk image backup as Hyper-V-compatible virtual disks (.vhdx format)
   RESTORETYPE_WINDISK_VHDX = 13
 
+  # RestoreType: Restore virtual machines directly to hypervisor
+  # This const is available in Comet 24.12.x and later.
+  RESTORETYPE_VMHOST = 14
+
   # RestoreType: Legacy name alias - Prefer to use RESTORETYPE_PROCESS_ARCHIVE since multiple archive file formats are supported within this single RESTORETYPE_
   RESTORETYPE_PROCESS_TARBALL = 3
 
@@ -615,7 +639,7 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # RetentionRangeType: Uses Timestamp
   RETENTIONRANGE_NEWER_THAN_X = 901
 
-  # RetentionRangeType: Uses Days, Weeks, Months
+  # RetentionRangeType: Uses Days, Weeks, Months, Years
   RETENTIONRANGE_JOBS_SINCE = 902
 
   # RetentionRangeType: Uses Days
@@ -640,11 +664,19 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # RetentionRangeType: Uses Jobs
   RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_MONTH = 909
 
+  # RetentionRangeType: Uses Jobs
+  RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_YEAR = 910
+
+  # RetentionRangeType: Uses Years, YearOffset
+  RETENTIONRANGE_FIRST_JOB_FOR_LAST_X_YEARS = 911
+
   # RetentionRangeType
-  RETENTIONRANGE__HIGHEST = 909
+  RETENTIONRANGE__HIGHEST = 911
 
   RETENTIONRANGE_MAXINT = 1_125_899_906_842_624
 
+  ROTATE_STORAGE_VAULT_KEYS_DEFAULT = 48
+
   SCHEDULE_FREQUENCY_LOWEST = 8010
 
   # SecondsPast should be a Unix timestamp, in seconds
@@ -665,7 +697,10 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # SecondsPast is the number of seconds per period. Offset: Shunt seconds after unix epoch
   SCHEDULE_FREQUENCY_PERIODIC = 8015
 
-  SCHEDULE_FREQUENCY_HIGHEST = 8015
+  # SecondsPast is the number of seconds past 00:00 1st, in the device's local timezone.
+  SCHEDULE_FREQUENCY_YEARLY = 8016
+
+  SCHEDULE_FREQUENCY_HIGHEST = 8016
 
   # Maximum random delay (5 hours)
   SCHEDULE_MAX_RANDOM_DELAY_SECS = 18_000
@@ -1017,6 +1052,9 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # StoredObjectType
   STOREDOBJECTTYPE_VMDK_SYMLINK = 'vmdksymlink'
 
+  # StoredObjectType
+  STOREDOBJECTTYPE_VMDK_WINDEDUP = 'vmdkwindedup'
+
   # StoredObjectType
   STOREDOBJECTTYPE_VIRTUALIMAGE_DISK = 'virtualimagedisk'
 

data/lib/comet/models/admin_options.rb

@@ -0,0 +1,72 @@
+# 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
+
+  # AdminOptions is a typed class wrapper around the underlying Comet Server API data structure.
+  class AdminOptions
+
+    # @type [Comet::PolicyOptions] policy
+    attr_accessor :policy
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @policy = Comet::PolicyOptions.new
+      @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 'Policy'
+          @policy = Comet::PolicyOptions.new
+          @policy.from_hash(v)
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Policy'] = @policy
+      @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/backup_job_detail.rb

@@ -99,6 +99,10 @@ module Comet
     # @type [Number] total_unlicensed_mails_count
     attr_accessor :total_unlicensed_mails_count
 
+    # The CRC32 of the billing data for this job.
+    # @type [Number] billing_crc_32
+    attr_accessor :billing_crc_32
+
     # If this field is present, this job did not perform some work because the Storage Vault is
     # currently busy.
     # This field is available in Comet 24.9.2 and later.
@@ -155,6 +159,7 @@ module Comet
       @total_accounts_count = 0
       @total_licensed_mails_count = 0
       @total_unlicensed_mails_count = 0
+      @billing_crc_32 = 0
       @conflicting_job_id = ''
       @cancellation_id = ''
       @progress = Comet::BackupJobProgress.new
@@ -276,6 +281,10 @@ module Comet
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
           @total_unlicensed_mails_count = v
+        when 'BillingCrc32'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @billing_crc_32 = v
         when 'ConflictingJobID'
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
@@ -343,6 +352,9 @@ module Comet
       unless @total_unlicensed_mails_count.nil?
         ret['TotalUnlicensedMailsCount'] = @total_unlicensed_mails_count
       end
+      unless @billing_crc_32.nil?
+        ret['BillingCrc32'] = @billing_crc_32
+      end
       unless @conflicting_job_id.nil?
         ret['ConflictingJobID'] = @conflicting_job_id
       end