comet_backup_ruby_sdk 2.41.0 → 2.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c972fed511fa56a76cf96c42f8559faddcc003fc4378616bb5b91ec0d45ef210
-  data.tar.gz: 945063cd41af3fb4b56728e2374e99c4463c18e7ca68ee6a916829d31c406959
+  metadata.gz: 223786459d14daf5ee8f6051b12e17a3421953090d8ef85ead703a849a40556a
+  data.tar.gz: 7946efba6f9689c679d407ef8188bd491aa73d91bfe73a074a518ef2b9b8232a
 SHA512:
-  metadata.gz: 4d84b541b325ded6b7f1ee7b111a2ef8110b2774b3097c1e1aa26d282543ece740fc6ec5eefaa14a6393f737c3525f4bc316f65b9ddbd135a3b664b3d3890d56
-  data.tar.gz: d5e8829fe4a04d7f792f4a982f9fe2ae4296de440845d494ccae9d644c8c3743bf7300db0460ba7015355cc821b862b7a28de7ce75d124822923e77b5624cb42
+  metadata.gz: 789be6fbbbf77f288c81b44cbdcf1ce99e8b743dfe83b82a778c4cce3467905f791b69f093379a12d05bafd2fbc9377e91519e3700f6b9d2b4de07e5b50272af
+  data.tar.gz: f6b7ab99a8c0544afdab435e3c8f5e77d671b3d8a3a7492fe8e87b38ae350bbebffab5e09977151dd7dd34bd2519922c3a1f65343bf05ff9a9cb9a99e6728621

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## 2025-11-14 v2.43.0
+
+- Based on Comet 25.9.6
+- Add new API methods for getting, setting, and deleting Protected Items and
+their associated schedules
+- Add new API methods for live connection credential/session management
+- Add JobID field to API response when starting jobs via the dispatcher on
+devices running Comet 25.9.6 or newer
+- Add support for custom tags on backup jobs to allow grouping of
+snapshots/jobs
+- Add support SAS Relic codesigning
+- Improve documentation for Proxmox API types
+
+## 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
 

data/Gemfile.lock

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

data/lib/comet/comet_server.rb

@@ -1059,6 +1059,33 @@ module Comet
       ret
     end
 
+    # AdminDeleteProtectedItem
+    #
+    # Delete a Protected Item.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_user Selected account username
+    # @param [String] source_id Selected Protected Item GUID
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_delete_protected_item(target_user, source_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, "'source_id' expected String, got #{source_id.class}" unless source_id.is_a? String
+
+      submit_params['SourceID'] = source_id
+
+      body = perform_request('api/v1/admin/delete-protected-item', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDeleteUser
     #
     # Delete user account.
@@ -1325,6 +1352,30 @@ module Comet
       ret
     end
 
+    # AdminDispatcherForceLogin
+    #
+    # Instruct a live connected device to re-enter login credentials.
+    # 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] target_id The live connection GUID
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_dispatcher_force_login(target_id)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+
+      body = perform_request('api/v1/admin/dispatcher/force-login', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherGetDefaultLoginUrl
     #
     # Get the default login URL for a tenant.
@@ -1749,6 +1800,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.
@@ -2146,7 +2278,7 @@ module Comet
     #
     # @param [String] target_id The live connection GUID
     # @param [String] backup_rule The schedule GUID
-    # @return [Comet::CometAPIResponseMessage]
+    # @return [Comet::DispatchWithJobIDResponse]
     def admin_dispatcher_run_backup(target_id, backup_rule)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
@@ -2159,7 +2291,7 @@ module Comet
       body = perform_request('api/v1/admin/dispatcher/run-backup', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::DispatchWithJobIDResponse.new
       ret.from_hash(json_body)
       ret
     end
@@ -2175,7 +2307,7 @@ module Comet
     # @param [String] source The Protected Item GUID
     # @param [String] destination The Storage Vault GUID
     # @param [Comet::BackupJobAdvancedOptions] options (Optional) Extra job parameters (>= 19.3.6)
-    # @return [Comet::CometAPIResponseMessage]
+    # @return [Comet::DispatchWithJobIDResponse]
     def admin_dispatcher_run_backup_custom(target_id, source, destination, options = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
@@ -2196,7 +2328,7 @@ module Comet
       body = perform_request('api/v1/admin/dispatcher/run-backup-custom', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::DispatchWithJobIDResponse.new
       ret.from_hash(json_body)
       ret
     end
@@ -2215,7 +2347,7 @@ module Comet
     # @param [String] destination The Storage Vault ID
     # @param [String] snapshot (Optional) If present, restore a specific snapshot. Otherwise, restore the latest snapshot for the selected Protected Item + Storage Vault pair
     # @param [Array<String>] paths (Optional) If present, restore these paths only. Otherwise, restore all data (>= 19.3.0)
-    # @return [Comet::CometAPIResponseMessage]
+    # @return [Comet::DispatchWithJobIDResponse]
     def admin_dispatcher_run_restore(target_id, path, source, destination, snapshot = nil, paths = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
@@ -2244,7 +2376,7 @@ module Comet
       body = perform_request('api/v1/admin/dispatcher/run-restore', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::DispatchWithJobIDResponse.new
       ret.from_hash(json_body)
       ret
     end
@@ -2266,7 +2398,7 @@ module Comet
     # @param [Number] known_file_count (Optional) The number of files to restore, if known. Supplying this means we don't need to walk the entire tree just to find the file count and will speed up the restoration process.
     # @param [Number] known_byte_count (Optional) The total size in bytes of files to restore, if known. Supplying this means we don't need to walk the entire tree just to find the total file size and will speed up the restoration process.
     # @param [Number] known_dir_count (Optional) The number of directories to restore, if known. Supplying this means we don't need to walk the entire tree just to find the number of directories and will speed up the restoration process.
-    # @return [Comet::CometAPIResponseMessage]
+    # @return [Comet::DispatchWithJobIDResponse]
     def admin_dispatcher_run_restore_custom(target_id, source, destination, options, snapshot = nil, paths = nil, known_file_count = nil, known_byte_count = nil, known_dir_count = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
@@ -2310,7 +2442,7 @@ module Comet
       body = perform_request('api/v1/admin/dispatcher/run-restore-custom', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::DispatchWithJobIDResponse.new
       ret.from_hash(json_body)
       ret
     end
@@ -2413,8 +2545,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
 
@@ -2422,6 +2555,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
@@ -2431,6 +2567,33 @@ module Comet
       ret
     end
 
+    # AdminDispatcherUpdateLoginPassword
+    #
+    # Instruct a live connected device to update its login password.
+    #
+    # 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] new_password The new password of this user
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_dispatcher_update_login_password(target_id, new_password)
+      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, "'new_password' expected String, got #{new_password.class}" unless new_password.is_a? String
+
+      submit_params['NewPassword'] = new_password
+
+      body = perform_request('api/v1/admin/dispatcher/update-login-password', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherUpdateLoginUrl
     #
     # Instruct a live connected device to update its login server URL.
@@ -2829,6 +2992,33 @@ module Comet
       ret
     end
 
+    # AdminGetProtectedItemWithBackupRules
+    #
+    # Get a Protected Item with its backup rules.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_user Selected account username
+    # @param [String] source_id Selected Protected Item GUID
+    # @return [Comet::ProtectedItemWithBackupRulesResponse]
+    def admin_get_protected_item_with_backup_rules(target_user, source_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, "'source_id' expected String, got #{source_id.class}" unless source_id.is_a? String
+
+      submit_params['SourceID'] = source_id
+
+      body = perform_request('api/v1/admin/get-protected-item-with-backup-rules', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::ProtectedItemWithBackupRulesResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminGetUserProfile
     #
     # Get user account profile.
@@ -4231,8 +4421,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
 
@@ -4252,6 +4443,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
@@ -4373,6 +4569,51 @@ module Comet
       ret
     end
 
+    # AdminSetProtectedItemWithBackupRules
+    #
+    # Add or update a Protected Item with its backup rules.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_user Selected account username
+    # @param [String] source_id Selected Protected Item GUID
+    # @param [String] require_hash (Optional) Previous account profile hash
+    # @param [Comet::SourceConfig] source (Optional) Optional Protected Item to create or update
+    # @param [Hash{String => Comet::BackupRuleConfig}] backup_rules (Optional) Optional backup rules for the Protected Item
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_set_protected_item_with_backup_rules(target_user, source_id, require_hash = nil, source = nil, backup_rules = nil)
+      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, "'source_id' expected String, got #{source_id.class}" unless source_id.is_a? String
+
+      submit_params['SourceID'] = source_id
+      unless require_hash.nil?
+        raise TypeError, "'require_hash' expected String, got #{require_hash.class}" unless require_hash.is_a? String
+
+        submit_params['RequireHash'] = require_hash
+      end
+      unless source.nil?
+        raise TypeError, "'source' expected Comet::SourceConfig, got #{source.class}" unless source.is_a? Comet::SourceConfig
+
+        submit_params['Source'] = source.to_json
+      end
+      unless backup_rules.nil?
+        raise TypeError, "'backup_rules' expected Hash, got #{backup_rules.class}" unless backup_rules.is_a? Hash
+
+        submit_params['BackupRules'] = backup_rules.to_json
+      end
+
+      body = perform_request('api/v1/admin/set-protected-item-with-backup-rules', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminSetUserProfile
     #
     # Modify user account profile.
@@ -4413,7 +4654,7 @@ module Comet
     # @param [Comet::UserProfileConfig] profile_data Modified user profile
     # @param [String] require_hash Previous hash parameter
     # @param [Comet::AdminOptions] admin_options (Optional) Instructions for modifying user profile
-    # @return [Comet::CometAPIResponseMessage]
+    # @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
@@ -4434,7 +4675,7 @@ module Comet
       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.5'
+  APPLICATION_VERSION = '25.9.6'
 
-  APPLICATION_VERSION_MAJOR = 24
+  APPLICATION_VERSION_MAJOR = 25
 
-  APPLICATION_VERSION_MINOR = 12
+  APPLICATION_VERSION_MINOR = 9
 
-  APPLICATION_VERSION_REVISION = 5
+  APPLICATION_VERSION_REVISION = 6
 
   # 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
 
@@ -322,6 +328,9 @@ module Comet
   # JobStatus: The job has encountered an error and will wait to retry.
   JOB_STATUS_RUNNING_TRYAGAIN = 6003
 
+  # JobStatus: The job has been created by the server but has not yet been initialized by the client.
+  JOB_STATUS_NOT_YET_STARTED = 6004
+
   # JobStatus
   JOB_STATUS_RUNNING__MAX = 6999
 
@@ -433,6 +442,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 +477,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 +490,18 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # PSAType
   PSA_TYPE_SYNCRO = 2
 
+  # PveBackupMethod
+  PVE_BACKUP_METHOD_STOP = 'stop'
+
+  # PveBackupMethod
+  PVE_BACKUP_METHOD_SUSPEND = 'suspend'
+
+  # PveBackupMethod
+  PVE_BACKUP_METHOD_SNAPSHOT = 'snapshot'
+
+  # PveBackupMethod
+  PVE_BACKUP_METHOD_DEFAULT = PVE_BACKUP_METHOD_SNAPSHOT
+
   RELEASE_CODENAME = 'Voyager'
 
   # RemoteServerType: Comet Server
@@ -619,7 +646,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
@@ -644,11 +671,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
@@ -669,7 +704,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
@@ -1021,6 +1059,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'
 
@@ -1143,4 +1184,7 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # WindowsCodesignMethod: Use a configured Azure Key Vault for Authenticode codesigning
   WINDOWSCODESIGN_METHOD_AZUREKEYVAULT = 4
 
+  # WindowsCodesignMethod: Use a configured SAS Relic server for Authenticode codesigning
+  WINDOWSCODESIGN_METHOD_RELICSERVER = 5
+
 end

data/lib/comet/models/backup_job_advanced_options.rb

@@ -50,6 +50,10 @@ module Comet
     # @type [String] log_level
     attr_accessor :log_level
 
+    # Default disabled
+    # @type [String] tags
+    attr_accessor :tags
+
     # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
     attr_accessor :unknown_json_fields
 
@@ -63,6 +67,7 @@ module Comet
       @auto_retention_level = 0
       @concurrency_count = 0
       @log_level = ''
+      @tags = ''
       @unknown_json_fields = {}
     end
 
@@ -107,6 +112,10 @@ module Comet
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
           @log_level = v
+        when 'Tags'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @tags = v
         else
           @unknown_json_fields[k] = v
         end
@@ -125,6 +134,7 @@ module Comet
       ret['AutoRetentionLevel'] = @auto_retention_level
       ret['ConcurrencyCount'] = @concurrency_count
       ret['LogLevel'] = @log_level
+      ret['Tags'] = @tags
       @unknown_json_fields.each do |k, v|
         ret[k] = v
       end

data/lib/comet/models/backup_job_detail.rb

@@ -122,6 +122,10 @@ module Comet
     # @type [Comet::SizeMeasurement] destination_size_end
     attr_accessor :destination_size_end
 
+    # The tags sent as BackupJobOptions, Useful for Groupings
+    # @type [String] tags
+    attr_accessor :tags
+
     # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
     attr_accessor :unknown_json_fields
 
@@ -160,6 +164,7 @@ module Comet
       @progress = Comet::BackupJobProgress.new
       @destination_size_start = Comet::SizeMeasurement.new
       @destination_size_end = Comet::SizeMeasurement.new
+      @tags = ''
       @unknown_json_fields = {}
     end
 
@@ -293,6 +298,10 @@ module Comet
         when 'DestinationSizeEnd'
           @destination_size_end = Comet::SizeMeasurement.new
           @destination_size_end.from_hash(v)
+        when 'Tags'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @tags = v
         else
           @unknown_json_fields[k] = v
         end
@@ -358,6 +367,9 @@ module Comet
       unless @destination_size_end.nil?
         ret['DestinationSizeEnd'] = @destination_size_end
       end
+      unless @tags.nil?
+        ret['Tags'] = @tags
+      end
       @unknown_json_fields.each do |k, v|
         ret[k] = v
       end