comet_backup_ruby_sdk 2.7.0 → 2.8.0

data/lib/comet/models/live_user_connection.rb

@@ -18,24 +18,35 @@ module Comet
     # @type [String] device_id
     attr_accessor :device_id
 
+    # The Comet Backup software version that this live-connected device reports that it is running. It
+    # takes the format "MAJOR.MINOR.PATCH", such as "23.2.0". See the APPLICATION_VERSION constant for
+    # more information.
     # @type [String] reported_version
     attr_accessor :reported_version
 
+    # The operating system of the device. It is one of the PLATFORM_ constants; then a forwardslash (/);
+    # then the device's GOARCH.
     # @type [String] reported_platform
     attr_accessor :reported_platform
 
+    # The operating system of the device, in extended detail.
     # @type [Comet::OSInfo] reported_platform_version
     attr_accessor :reported_platform_version
 
+    # The reported timezone of the device, in IANA format.
     # @type [String] device_time_zone
     attr_accessor :device_time_zone
 
+    # The live-connected device's remote IP address, as seen from the Comet Server.
     # @type [String] ipaddress
     attr_accessor :ipaddress
 
+    # Unix timestamp, in seconds.
     # @type [Number] connection_time
     attr_accessor :connection_time
 
+    # The current state of the "Allow administrator to view my files" client-side option. If this option
+    # is refused, some live-connected actions will be refused by the device.
     # @type [Boolean] allows_filenames
     attr_accessor :allows_filenames
 

data/lib/comet/models/mongo_dbconnection.rb

@@ -27,6 +27,8 @@ module Comet
     # @type [String] authentication_db
     attr_accessor :authentication_db
 
+    # Prior to Comet 22.12.3, must be a filesystem path to `mongo` (n.b. not `mongosh`). In Comet >=
+    # 22.12.3, not used.
     # @type [String] mongo_shell_path
     # @deprecated This member has been deprecated since Comet version 22.12.3
     attr_accessor :mongo_shell_path

data/lib/comet/models/office_365object_info.rb

@@ -21,6 +21,7 @@ module Comet
     # @type [String] type
     attr_accessor :type
 
+    # May be an email address or a SharePoint site URL
     # @type [String] value
     attr_accessor :value
 

data/lib/comet/models/request_storage_vault_response_message.rb

@@ -12,6 +12,7 @@ module Comet
   # RequestStorageVaultResponseMessage is a typed class wrapper around the underlying Comet Server API data structure.
   class RequestStorageVaultResponseMessage
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/restore_job_advanced_options.rb

@@ -15,54 +15,72 @@ module Comet
     # @type [Number] type
     attr_accessor :type
 
+    # For RESTORETYPE_FILE
     # @type [Boolean] overwrite_existing_files
     attr_accessor :overwrite_existing_files
 
+    # For RESTORETYPE_FILE. If set, OverwriteExistingFiles must be true
     # @type [Boolean] overwrite_if_newer
     attr_accessor :overwrite_if_newer
 
+    # For RESTORETYPE_FILE. If set, DestPath must be blank
     # @type [Boolean] dest_is_original_location
     attr_accessor :dest_is_original_location
 
+    # For RESTORETYPE_FILE or RESTORETYPE_PROCESS_xxx
     # @type [String] dest_path
     attr_accessor :dest_path
 
+    # For RESTORETYPE_WINDISK only. Must have one entry for each selected restore path
     # @type [Array<String>] exact_dest_paths
     attr_accessor :exact_dest_paths
 
+    # For RESTORETYPE_FILE_ARCHIVE or RESTORETYPE_PROCESS_ARCHIVE. Default 0 is *.tar, for backward
+    # compatibility
     # @type [Number] archive_format
     attr_accessor :archive_format
 
+    # For RESTORETYPE_OFFICE365_CLOUD.
     # @type [Comet::Office365Credential] office_365credential
     attr_accessor :office_365credential
 
+    # For RESTORETYPE_MYSQL
     # @type [String] username
     attr_accessor :username
 
+    # For RESTORETYPE_MYSQL
     # @type [String] password
     attr_accessor :password
 
+    # For RESTORETYPE_MYSQL
     # @type [String] host
     attr_accessor :host
 
+    # For RESTORETYPE_MYSQL
     # @type [String] port
     attr_accessor :port
 
+    # For RESTORETYPE_MYSQL
     # @type [Boolean] use_ssl
     attr_accessor :use_ssl
 
+    # For RESTORETYPE_MYSQL i.e.: Self signed certs
     # @type [Boolean] ssl_allow_invalid
     attr_accessor :ssl_allow_invalid
 
+    # For RESTORETYPE_MYSQL
     # @type [String] ssl_ca_file
     attr_accessor :ssl_ca_file
 
+    # For RESTORETYPE_MYSQL
     # @type [String] ssl_crt_file
     attr_accessor :ssl_crt_file
 
+    # For RESTORETYPE_MYSQL
     # @type [String] ssl_key_file
     attr_accessor :ssl_key_file
 
+    # For RESTORETYPE_MSSQL.
     # @type [Comet::MSSQLLoginArgs] ms_sql_connection
     attr_accessor :ms_sql_connection
 

data/lib/comet/models/retention_policy.rb

@@ -12,6 +12,7 @@ module Comet
   # RetentionPolicy is a typed class wrapper around the underlying Comet Server API data structure.
   class RetentionPolicy
 
+    # One of the RETENTIONMODE_ constants
     # @type [Number] mode
     attr_accessor :mode
 

data/lib/comet/models/retention_range.rb

@@ -30,6 +30,7 @@ module Comet
     # @type [Number] months
     attr_accessor :months
 
+    # 0: Sunday, 6: Saturday
     # @type [Number] week_offset
     attr_accessor :week_offset
 

data/lib/comet/models/s3destination_location.rb

@@ -33,6 +33,7 @@ module Comet
     # @type [String] s3custom_region
     attr_accessor :s3custom_region
 
+    # If true, use legacy v2 signing. If false (default), use modern v4 signing
     # @type [Boolean] s3uses_v2signing
     attr_accessor :s3uses_v2signing
 

data/lib/comet/models/search_snapshots_response.rb

@@ -12,6 +12,7 @@ module Comet
   # SearchSnapshotsResponse is a typed class wrapper around the underlying Comet Server API data structure.
   class SearchSnapshotsResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/server_config_options.rb

@@ -24,6 +24,11 @@ module Comet
     # @type [Comet::ConstellationRoleOptions] constellation_role
     attr_accessor :constellation_role
 
+    # This field is defined for compatibility with 17.x.x versions of Comet Server. Do not rely on this
+    # field. In Comet 23.2.x, if this field is defined, it is imported into the replacement
+    # 'ConstellationRole' field under the assumption that you are upgrading this Comet Server from a
+    # 17.x.x version. In Comet 23.3.x and later, this field is ignored and will not be respected during
+    # the import process.
     # @type [Comet::ConstellationRoleOptions] constellation_role__legacy
     attr_accessor :constellation_role__legacy
 

data/lib/comet/models/server_meta_branding_properties.rb

@@ -18,9 +18,13 @@ module Comet
     # @type [String] product_name
     attr_accessor :product_name
 
+    # If true, this Comet Server has an image configured for its main logo. You can access it from the
+    # /gen/logo.img endpoint. If false, this Comet Server has text configured for its main logo.
     # @type [Boolean] has_image
     attr_accessor :has_image
 
+    # A value that will change if the branding image (/gen/logo.img) changes. You can use this as a
+    # cache key.
     # @type [String] image_etag
     attr_accessor :image_etag
 

data/lib/comet/models/server_meta_version_info.rb

@@ -28,6 +28,7 @@ module Comet
     attr_accessor :software_build_role
 
     # @type [Boolean] constellation_role__legacy
+    # @deprecated This member has been deprecated since Comet version 18.2.0 "Overseer Role" was the old name for the Constellation Role. This field is a duplicate of ConstellationRole for backward compatibility with earlier API consumers.
     attr_accessor :constellation_role__legacy
 
     # @type [Boolean] constellation_role
@@ -36,15 +37,22 @@ module Comet
     # @type [Array<String>] experimental_options
     attr_accessor :experimental_options
 
+    # Unix timestamp, in seconds.
     # @type [Number] server_start_time
     attr_accessor :server_start_time
 
+    # A GUID that was randomly generated when this Comet Server started up. You can check this value to
+    # see if the Comet Server has restarted.
     # @type [String] server_start_hash
     attr_accessor :server_start_hash
 
+    # The current time on the Comet Server host machine. Unix timestamp, in seconds. You can check this
+    # value to see if clock drift is occuring.
     # @type [Number] current_time
     attr_accessor :current_time
 
+    # A hash derived from the Comet Server's serial number. You can check this value to see if two Comet
+    # Server endpoints point to an identical server.
     # @type [String] server_license_hash
     attr_accessor :server_license_hash
 

data/lib/comet/models/session_key_regenerated_response.rb

@@ -12,6 +12,7 @@ module Comet
   # SessionKeyRegeneratedResponse is a typed class wrapper around the underlying Comet Server API data structure.
   class SessionKeyRegeneratedResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/sftpdestination_location.rb

@@ -21,6 +21,7 @@ module Comet
     # @type [String] sftpremote_path
     attr_accessor :sftpremote_path
 
+    # One of the DESTINATION_SFTP_AUTHMODE_ constants
     # @type [Number] sftpauth_mode
     attr_accessor :sftpauth_mode
 

data/lib/comet/models/source_config.rb

@@ -12,6 +12,7 @@ module Comet
   # SourceConfig is a typed class wrapper around the underlying Comet Server API data structure.
   class SourceConfig
 
+    # One of the ENGINE_BUILTIN_ constants
     # @type [String] engine
     attr_accessor :engine
 
@@ -27,18 +28,68 @@ module Comet
     # @type [Number] modify_time
     attr_accessor :modify_time
 
+    # Custom commands to run before the job
     # @type [Array<String>] pre_exec
     attr_accessor :pre_exec
 
+    # Custom commands to run after taking a disk snapshot
     # @type [Array<String>] thaw_exec
     attr_accessor :thaw_exec
 
+    # Custom commands to run after the job
     # @type [Array<String>] post_exec
     attr_accessor :post_exec
 
+    # Configuration for the selected Protected Item type. Each "Engine" supports
+    # different configuration options for the EngineProps values.
+    #
+    # For engine1/file, Comet understands the following EngineProp keys:
+    #
+    # - Any key starting with INCLUDE: A path that is included
+    # - Any key starting with EXCLUDE: An exclusion (glob format)
+    # - Any key starting with REXCLUDE: An exclusion (regular expression format)
+    # - Any key starting with PINCLUDE: A JSON string {"TopDirectory": "", "Value": ""}. TopDirectory is
+    # the path where starts to match the value; Value is an inclusion (glob format)
+    # - Any key starting with RINCLUDE: A JSON string {"TopDirectory": "", "Value": ""}. TopDirectory is
+    # the path where starts to match the value; Value is an inclusion (regular expression format)
+    # - Any key starting with SMBAUTH: A set of Windows network share credentials in WinSMBAuth JSON
+    # format
+    # - USE_WIN_VSS: If present, the 'Take filesystem snapshot' checkbox is checked
+    # - CONFIRM_EFS: If present, the 'Dismiss EFS warning' checkbox is checked
+    # - RESCAN_UNCHANGED: If present, the 'Rescan unchanged files' checkbox is checked
+    #
+    # For engine1/mssql, Comet understands the following EngineProp keys:
+    #
+    # - ALL_DATABASES: If present, include all databases with specified exclusions. If not present, only
+    # back up the specified inclusions
+    # - Any key starting with DATABASE- : A database that is included. Only valid if ALL_DATABASES is
+    # not present.
+    # - Any key starting with EXCEPT-DATABASE- : A database that is excluded. Only valid if
+    # ALL_DATABASES is present.
+    # - INSTANCE: The Microsoft SQL Server instance name
+    # - USERNAME: The username to connect to Microsoft SQL Server
+    # - PASSWORD: The password to connect to Microsoft SQL Server
+    # - AUTHMODE: Either "windows" or "native" (corresponding to the declared MSSQL_AUTH_WINDOWS and
+    # MSSQL_AUTH_NATIVE constant values). If not present, use native authentication if the USERNAME
+    # and/or PASSWORD fields are filled in, use windows authentication if they are blank
+    # - METHOD: Either "OLEDB_NATIVE" or "OLEDB_32" (corresponding to the declared
+    # MSSQL_METHOD_OLEDB_NATIVE and MSSQL_METHOD_OLEDB_32 constant values). If not present, defaults to
+    # Native
+    # - DIFFBASE: If present, take a "Full (base image)" backup job. Otherwise, take a "Full (copy
+    # only)" backup job.
+    # - DIFFERENTIAL: If present, take a "Differential increment" backup job. Otherwise, take a "Full
+    # (copy only)" backup job.
+    # - LOGTRUNC: If present, take a "Log (truncating)" backup job. Otherwise, take a "Full (copy only)"
+    # backup job.
+    # - LOGNOTRUNC: If present, take a "Log (no truncation)" backup job. Otherwise, take a "Full (copy
+    # only)" backup job.
+    #
     # @type [Hash{String => String}] engine_props
     attr_accessor :engine_props
 
+    # By default, backup jobs from this Protected Item will be subject
+    # to the overall retention policy for the Storage Vault. You can override the policy
+    # for specific Storage Vaults by putting their destination ID as a key here.
     # @type [Hash{String => Comet::RetentionPolicy}] override_destination_retention
     attr_accessor :override_destination_retention
 

data/lib/comet/models/sshconnection.rb

@@ -18,6 +18,7 @@ module Comet
     # @type [String] sshusername
     attr_accessor :sshusername
 
+    # One of the SSHCONNECTION_AUTHMODE_ constants
     # @type [Number] sshauth_mode
     attr_accessor :sshauth_mode
 

data/lib/comet/models/swift_destination_location.rb

@@ -12,24 +12,30 @@ module Comet
   # SwiftDestinationLocation is a typed class wrapper around the underlying Comet Server API data structure.
   class SwiftDestinationLocation
 
+    # Username or UserID or Application Credential name or Application Credential ID, or blank for token
+    # authentication
     # @type [String] username
     attr_accessor :username
 
+    # User Password, or Application Credential Key, or token if the Username field is blank
     # @type [String] apikey
     attr_accessor :apikey
 
     # @type [String] region
     attr_accessor :region
 
+    # Mandatory
     # @type [String] auth_url
     attr_accessor :auth_url
 
     # @type [String] domain
     attr_accessor :domain
 
+    # Tenant name (v2) or Project name (v3)
     # @type [String] tenant
     attr_accessor :tenant
 
+    # Project domain name (v3)
     # @type [String] tenant_domain
     attr_accessor :tenant_domain
 
@@ -40,6 +46,7 @@ module Comet
     attr_accessor :trust_id
 
     # @type [String] auth_token
+    # @deprecated This member has been deprecated since Comet version 17.8.0
     attr_accessor :auth_token
 
     # @type [String] prefix

data/lib/comet/models/test_response.rb

@@ -12,6 +12,7 @@ module Comet
   # TestResponse is a typed class wrapper around the underlying Comet Server API data structure.
   class TestResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/time_span.rb

@@ -12,9 +12,11 @@ module Comet
   # TimeSpan is a typed class wrapper around the underlying Comet Server API data structure.
   class TimeSpan
 
+    # SCHEDULE_FREQUENCY_<TYPE>
     # @type [Number] frequency_type
     attr_accessor :frequency_type
 
+    # Used for Periodic and Once Only
     # @type [Number] seconds
     attr_accessor :seconds
 

data/lib/comet/models/totp_regenerated_response.rb

@@ -12,6 +12,7 @@ module Comet
   # TotpRegeneratedResponse is a typed class wrapper around the underlying Comet Server API data structure.
   class TotpRegeneratedResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/u2fregistration_challenge_response.rb

@@ -13,6 +13,7 @@ module Comet
   # @deprecated This type has been deprecated since Comet version 21.12.0
   class U2FRegistrationChallengeResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/uninstall_config.rb

@@ -10,11 +10,15 @@ require 'json'
 module Comet
 
   # UninstallConfig is a typed class wrapper around the underlying Comet Server API data structure.
+  # UninstallConfig allows configuring whether the target device will be uninstalled or not.
   class UninstallConfig
 
+    # If this option is true, the target device will receive a message asking it to uninstall the Comet
+    # Backup app.
     # @type [Boolean] uninstall_flag
     attr_accessor :uninstall_flag
 
+    # This controls the "Remove all user settings from this device" option.
     # @type [Boolean] remove_config_file
     attr_accessor :remove_config_file
 

data/lib/comet/models/update_campaign_options.rb

@@ -28,9 +28,12 @@ module Comet
     # @type [Boolean] downgrade_newer
     attr_accessor :downgrade_newer
 
+    # Choose whether this bulk upgrade campaign is allowed to interrupt a running backup job.
     # @type [Boolean] force_upgrade_running
     attr_accessor :force_upgrade_running
 
+    # If true, then the UserFilter will be used to restrict which accounts and devices will be eligible
+    # for the software update. If false, all users and devices will be eligible for the software update.
     # @type [Boolean] apply_device_filter
     attr_accessor :apply_device_filter
 

data/lib/comet/models/update_campaign_properties.rb

@@ -24,9 +24,12 @@ module Comet
     # @type [Boolean] downgrade_newer
     attr_accessor :downgrade_newer
 
+    # Choose whether this bulk upgrade campaign is allowed to interrupt a running backup job.
     # @type [Boolean] force_upgrade_running
     attr_accessor :force_upgrade_running
 
+    # If true, then the UserFilter will be used to restrict which accounts and devices will be eligible
+    # for the software update. If false, all users and devices will be eligible for the software update.
     # @type [Boolean] apply_device_filter
     attr_accessor :apply_device_filter
 

data/lib/comet/models/update_campaign_status.rb

@@ -24,9 +24,12 @@ module Comet
     # @type [Boolean] downgrade_newer
     attr_accessor :downgrade_newer
 
+    # Choose whether this bulk upgrade campaign is allowed to interrupt a running backup job.
     # @type [Boolean] force_upgrade_running
     attr_accessor :force_upgrade_running
 
+    # If true, then the UserFilter will be used to restrict which accounts and devices will be eligible
+    # for the software update. If false, all users and devices will be eligible for the software update.
     # @type [Boolean] apply_device_filter
     attr_accessor :apply_device_filter
 

data/lib/comet/models/user_on_server.rb

@@ -12,6 +12,8 @@ module Comet
   # UserOnServer is a typed class wrapper around the underlying Comet Server API data structure.
   class UserOnServer
 
+    # The server where this user was found. The 0-based indexes here correspond to the entries inside
+    # ConstellationRoleOptions->Servers.
     # @type [Number] server_id
     attr_accessor :server_id
 

data/lib/comet/models/user_profile_config.rb

@@ -13,15 +13,22 @@ module Comet
   # This is the main data structure for a user's profile.
   class UserProfileConfig
 
+    # The name for this account. It uniquely identifies this UserProfileConfig across the entire Comet
+    # Server. It cannot be changed directly.
     # @type [String] username
     attr_accessor :username
 
+    # A longer descriptive name for this account. It is not necessarily unique to the Comet Server. The
+    # end-user might be able to change it inside the Comet Backup desktop app.
     # @type [String] account_name
     attr_accessor :account_name
 
+    # Timezone in IANA format. Individual devices may declare a more specific timezone in the Devices
+    # field.
     # @type [String] local_timezone
     attr_accessor :local_timezone
 
+    # One of the supported languages, such as en_US (DEFAULT_LANGUAGE).
     # @type [String] language_code
     attr_accessor :language_code
 
@@ -29,12 +36,17 @@ module Comet
     # @type [String] organization_id
     attr_accessor :organization_id
 
+    # A list of email addresses to send reports to.
     # @type [Array<String>] emails
     attr_accessor :emails
 
+    # By default, all the email addresses in the Emails field will receieve the policy-default or
+    # server-wide-default style of email report. Add an override for a specific email address in here to
+    # allow customizing the email report that will be received.
     # @type [Hash{String => Comet::UserCustomEmailSettings}] override_email_settings
     attr_accessor :override_email_settings
 
+    # This option can be used to control whether any email reports are sent.
     # @type [Boolean] send_email_reports
     attr_accessor :send_email_reports
 
@@ -46,27 +58,41 @@ module Comet
     # @type [Hash{String => Comet::SourceConfig}] sources
     attr_accessor :sources
 
+    # Schedules
     # @type [Hash{String => Comet::BackupRuleConfig}] backup_rules
     attr_accessor :backup_rules
 
+    # Devices
+    # To revoke a device, use the AdminRevokeDevice API instead of accessing these fields directly. This
+    # API can also remove associated Protected Items, uninstall the remote device, and disconnect its
+    # live connection.
     # @type [Hash{String => Comet::DeviceConfig}] devices
     attr_accessor :devices
 
     # @type [Boolean] is_suspended
     attr_accessor :is_suspended
 
+    # Unix timestamp in seconds. Zero if the device is not suspended.
     # @type [Number] last_suspended
     attr_accessor :last_suspended
 
+    # A limit on the total Size of all Protected Items in this account. The number of bytes should be
+    # configured in AllProtectedItemsQuotaBytes.
     # @type [Boolean] all_protected_items_quota_enabled
     attr_accessor :all_protected_items_quota_enabled
 
+    # A limit on the total Size of all Protected Items in this account. It is enforced if
+    # AllProtectedItemsQuotaEnabled is true.
     # @type [Number] all_protected_items_quota_bytes
     attr_accessor :all_protected_items_quota_bytes
 
+    # A limit on the total number of devices registered in this account. Set to zero to allow unlimited
+    # devices.
     # @type [Number] maximum_devices
     attr_accessor :maximum_devices
 
+    # A limit on the total number of Office 365 Protected Accounts across all Office 365 Protected Items
+    # in this account. Set to zero to allow unlimited Office 365 Protected Accounts.
     # @type [Number] quota_office_365protected_accounts
     attr_accessor :quota_office_365protected_accounts
 
@@ -76,6 +102,8 @@ module Comet
     # @type [String] policy_id
     attr_accessor :policy_id
 
+    # The Policy field contains a read-only copy of the effective Policy that is applied to this user
+    # account.
     # @type [Comet::UserPolicy] policy
     attr_accessor :policy
 
@@ -87,6 +115,9 @@ module Comet
     # @type [String] password_hash
     attr_accessor :password_hash
 
+    # If this field is empty, the "Allow administrator to reset my password" feature is turned off. If
+    # this field is filled, it contains a cryptographic root of trust that can decrypt and re-encrypt
+    # other secrets in this profile.
     # @type [String] password_recovery
     attr_accessor :password_recovery
 
@@ -102,15 +133,20 @@ module Comet
     # @type [String] totpkey
     attr_accessor :totpkey
 
+    # This field is available in Comet 20.3.4 and later.
     # @type [Boolean] require_password_change
     attr_accessor :require_password_change
 
+    # Unix timestamp in seconds
     # @type [Number] create_time
     attr_accessor :create_time
 
+    # A random GUID that is allocated when the user profile is created for the first time. You can use
+    # this to help disambiguate users with the same username across multiple Comet Servers.
     # @type [String] creation_guid
     attr_accessor :creation_guid
 
+    # Additional server-wide settings that are enforced for this user profile
     # @type [Comet::UserServerConfig] server_config
     attr_accessor :server_config
 

data/lib/comet/models/vmdksnapshot_view_options.rb

@@ -12,12 +12,16 @@ module Comet
   # VMDKSnapshotViewOptions is a typed class wrapper around the underlying Comet Server API data structure.
   class VMDKSnapshotViewOptions
 
+    # Request a list of stored objects in vmdk file. It should be always true for restoring single files
+    # from vmdk file
     # @type [Boolean] enabled
     attr_accessor :enabled
 
+    # The vmdk filename inside subdirectory of disk image, should be end with .vmdk
     # @type [String] partition_guid
     attr_accessor :partition_guid
 
+    # Browse objects' paths inside vmdk file
     # @type [String] list_path
     attr_accessor :list_path
 

data/lib/comet/models/web_authn_registration_challenge_response.rb

@@ -12,6 +12,7 @@ module Comet
   # WebAuthnRegistrationChallengeResponse is a typed class wrapper around the underlying Comet Server API data structure.
   class WebAuthnRegistrationChallengeResponse
 
+    # If the operation was successful, the status will be in the 200-299 range.
     # @type [Number] status
     attr_accessor :status
 

data/lib/comet/models/win_smbauth.rb

@@ -12,15 +12,21 @@ module Comet
   # WinSMBAuth is a typed class wrapper around the underlying Comet Server API data structure.
   class WinSMBAuth
 
+    # The UNC path for the Windows network share (SMB).
     # @type [String] share_path
     attr_accessor :share_path
 
+    # The username to log in to the Windows network share (SMB).
     # @type [String] username
     attr_accessor :username
 
+    # The password might be hashed. To set this in cleartext, set PasswordFormat to 0
+    # (PASSWORD_FORMAT_PLAINTEXT).
     # @type [String] password
     attr_accessor :password
 
+    # The hash algorithm that is used for the Password field. It is one of the PASSWORD_FORMAT_
+    # constants.
     # @type [Number] password_format
     attr_accessor :password_format