GetUser (v1,v2)
This API can be used to retrieve the information of a backup user.
The settings can be found on the AhsayCBS web console at:
- Backup / Restore > Users, Groups & Policies > Backup User > %User Name%
v1 GetUser.do
URL
https://CBS.EXAMPLE.COM/obs/api/json/GetUser.do
Deprecated Since Version: 7.15.6.38
v2 GetUser.do
URL
https://CBS.EXAMPLE.COM/obs/api/json/2/GetUser.do
Available Since Version: 9.7
Parameters
Key | Type | Description |
---|---|---|
SysUser | String | Username of an AhsayCBS System User with Admin or API role. |
SysPwd | String | Password matching SysUser. |
LoginName | String | Backup user name. |
Owner | String | Owner of the backup user (if applicable). |
Return Values
Key | Type | Description |
---|---|---|
Status | String | "OK" or "Error" |
Data | JSON Object | Details of the user. |
Message | String | Error message, it only appears if status displays "Error". |
ExptType | String | The type of exception, will only be displayed if the status is "Error". |
JSON Objects
User
Key | Type | Description |
---|---|---|
AccessToken | String | Client API token that is used by OBC, should have no use to customers. |
AdGroup | String | Legacy v6 Advertisement group (not used by AhsayCBS). |
AdGroups | Array | Legacy v6 Advertisement groups (not used by AhsayCBS). |
Alias | String | Display name. |
BackupSetIdList | Array | ID number of each backup set. |
Bandwidth | Long | v6 bandwidth |
ClientRunVersion | String | Version of the backup client used. |
ClientType | String | Type of backup client, either ACB or OBM. |
ComputerNameDirList | Array | Path to the client logs. |
ContactList | JSON Object | See ContactList. |
DoubleEncodedName | String | Gets the double URL encoded name of the backup user. |
EmailReportSettings | JSON Object | See EmailReportSettings. |
EncodedName | String | Encoded name of the backup user. |
File | String | Path to users.xml. |
ForgotPasswordSettings | JSON Object | See ForgotPasswordSettings. |
FullName | String | For legacy v6 backup sets. The value is only set with the value of "LongLoginName" for get profile request received from Backup Client. |
GroupPolicySettings | JSON Object | See GroupPolicySettings. |
HashedPassword | Boolean | Legacy, unused by AhsayCBS. |
HomeDir | String | Path of the User Home. |
HostCount | Integer | Current client host limit in use. |
HostInfo | JSON Object | Number of CPU in client computer of each Run on Client backup set and Owner of each Run on Client backup set. |
Hostname | String | AhsayCBS server host name. |
HostQuota | Long | Client host limit. |
HostQuotaEnabled | Boolean | True / False |
HostSet | JSON Object | See HostSet. |
Id | Long | Millisecond time format. |
ImportDate | Long | Millisecond time format (0c=cnot imported user). |
Language | String | Language used. |
LastClientLoginTime | Long | Time of last login in backup client, in millisecond time format. |
LastLoginTime | Long | Time of last login, in millisecond time format. |
LastShowingLicViolationTime | Long | License violation time. |
LastSuccessfulLoginInfo | JSON Object | Info about the successful login by the user including IP Address, application & time. |
LdapSettings | JSON Object | See LdapSettings. |
Locked | Boolean | True / False |
LockedByMFA | Boolean | Whether account is locked due to too many MFA failure because of wrong passcode. |
LongLoginName | String | If user is owned by Sub-Admin the response will include the Username appended with Sub-Admin ID number (example, JohnDoe#12345). |
MailboxUsage | Integer | Count for Mailbox usage. |
ModuleSettings | JSON Object | See ModuleSettings. |
ModulesSettings | JSON Object | See ModulesSettings. |
MoveUserHomeRecord | JSON Object | Record for moving User Home. |
Name | String | User name. |
NewBSetName | String | Backup set name when Default Backup Set Name policy setting is disabled. |
Notes | String | User notes. |
OpenDirectUsageCount | Integer | Count for OpenDirect usage. |
Owner | String | Owner of the backup user. |
Password | String | Hashed password. |
PasswordHistory | JSON Object | See PasswordHistory. |
PreV7 | Boolean | True / False |
ProxySettings | JSON Object | See ProxySettings. |
QuotaList | JSON Object (Array) | Array list (see QuotaList). |
RegistrationDate | Long | Timestamp of registration date. |
RoutineJobsSettings | JSON Object | See RoutineJobsSettings. |
RunDirectQuota | Integer | Quota for Run Direct. |
RunDirectQuotaEnabled | Boolean | True / False |
SavePassword | Boolean | True / False |
SecurityIdentifier | String | For client to handle Schedule/CDP/Reminder in Windows. |
SecuritySettings | JSON Object | v8.3 SecuritySetting entity of the backup user including the phone list, whether individual MFA is enabled or not, etc. |
ServerSettings | JSON Object | Settings for returning to backup client only. |
SoftwareUpdateSettings | JSON Object | See SoftwareUpdateSettings. |
Status | String | Status of the backup user, either Suspended or Enable. |
SuspendPaidUserDate | String | Suspend date for Paid/Trial user in YYYYMMDD format. |
Timezone | String | Time zone. |
TopDir | String | Path to User Home. |
TotalStatistics | JSON Object | See TotalStatistics. |
TrialDays | Long | Days for trial. |
Type | String | Type of user, either TRIAL or PAID. Default to TRIAL if not specified. |
Updated | Boolean | Whether user was updated in cache but not yet saved to users.xml. |
UploadEncryptionKey | Boolean | True / False |
UserHome | String | Path to the User Home. |
UserId | String | Client user name. |
UserLockSettings | JSON Object | See UserLockSettings. |
UserSuspendSettings | JSON Object | See UserSuspendSettings. |
V6File | String | Path to v6 Profile.xml (regardless if AhsayCBS created user or import). |
WindowsEventLogSettings | JSON Object | See WindowsEventLogSettings. |
QuotaType | String | Type of quota, either TOTAL_QUOTA or PER_DESTINATION_QUOTA. |
StorageQuota | Long | Total quota in GB. |
EnableAUA | Boolean | Enable / disable Auto Update Agent. |
QuotaList
Key | Type | Description |
---|---|---|
Enabled | Boolean | True / False |
DestinationName | String | Name of the backup destination. |
DestinationKey | String | ID of the predefined destination or "OBS" for quota on AhsayCBS. |
Quota | Long | Unit in bytes. |
ContactList
Key | Type | Description |
---|---|---|
Company | String | Name of the company of the contact. |
String | Email address of the contact. | |
Address | String | Address of the contact. |
EmailCertificate | String | Email certificate of the contact. |
Website | String | Website of the contact. |
Name | String | Name of the contact. |
Phone1 | String | Phone number of the contact. |
Phone2 | String | Alternate phone number of the contact. |
EncryptEmail | Boolean | True / False |
EmailReportSettings
Key | Type | Description |
---|---|---|
SendBkpRpt | Boolean | True / False |
Usage | Long | Usage statistics. |
SmtpAuthUser | String | SMTP authorized user. |
ReportSenderEmail | String | Email address of the report sender. |
SendBkpRptMode | String | Mode for sending backup reports. |
SmtpHostName | String | Host name of the SMTP. |
MissedBkpInterval | Long | Missed backup intervals. |
SmtpPort | String | Port used for SMTP (e.g.8629). |
SendMissedBkpRpt | Boolean | True / False |
SendStorageAlert | Boolean | True / False |
SmtpAuthPwd | String | Password for SMTP. |
String | Email address. | |
Enabled | Boolean | True / False |
ForgotPasswordSettings
Key | Type | Description |
---|---|---|
RequestTime | Long | Time requested. |
ResetTime | Long | Time reset. |
GroupPolicySettings
Key | Type | Description |
---|---|---|
UserGroupIDList | Array | Assigned User Group(s) ID. |
ExcludeNetworkShare | Boolean | Legacy v6 Policy Group option, not available to update/use in AhsayCBS. |
GroupQuota | Integer/Long | Group quota backups. |
UsedGroupQuota | Integer/Long | Total group quota used. |
FileSizeLimit | Long | Files restricted to specified size. |
HostInfo
Key | Type | Description |
---|---|---|
Hosts | Array | Number of CPU socket and host name. |
HostSet
Key | Type | Description |
---|---|---|
"String":"string" | String | Contains host name of device installed with client. |
LastSuccessfulLoginInfo
Key | Type | Description |
---|---|---|
Type | String | OS and Browser or client type used to login. |
PhoneNumber | Long | Phone number if MFA is used. |
IpAddress | String | IP address used to login. |
Time | Long | Time of last login in millisecond time format. |
Id | Long | Timestamp in millisecond time format (auto-generate). |
LdapSettings
Key | Type | Description |
---|---|---|
LdapUser | Boolean | True / False. |
LastDeleteTime | Long | Time last deleted. |
LastDisableTime | Long | Time last disabled. |
FirstAuthFailureTime | Long | Time of first authentication failure. |
ModuleSettings
Key | Type | Description |
---|---|---|
CDPEnabled | Boolean | If feature is enabled. |
DeduplicationEnabled | Boolean | If feature is enabled. |
DeltaMergeEnabled | Boolean | If feature is enabled. |
InFileDeltaEnabled | Boolean | If feature is enabled. |
LotusDominoBackupEnabled | Boolean | If feature is enabled. |
LotusNotesBackupEnabled | Boolean | If feature is enabled. |
MariaDBBackupEnabled | Boolean | If feature is enabled. |
MobileEnabled | Boolean | If AhsayMOB is enabled (deprecated v8.5+). |
MobileQuota | Long | Quota value for AhsayMOB (deprecated v8.5+). |
MobileV2Enabled | Boolean | If Ahsay Mobile feature is enabled. |
MobileV2Quota | Long | Value fixed at 10 when MobileV2Enabled=true. |
MSExchangeBackupEnabled | Boolean | If feature is enabled. |
MSExchangDAGServerQuota | Long | Quota value for MS Exchange Server. |
MSExchangeMailboxBackupEnabled | Boolean | If feature is enabled. |
MSExMailboxQuota | Long | Quota value for MS Exchange Mailbox module. |
MSHyperVBackupEnabled | Boolean | If feature is enabled. |
MSHyperVVMQuota | Long | Quota value for Hyper-V. |
MSHyperVVMQuotaType | String | Quota type, either Guest VM or Socket. |
MSSQLBackupEnabled | Boolean | If feature is enabled. |
MSWindowsSystemBackupEnabled | Boolean | If feature is enabled. |
MSWindowsSystemStateBackupEnabled | Boolean | If feature is enabled. |
MySQLBackupEnabled | Boolean | If feature is enabled. |
NasClientEnabled | Boolean | If Synology NAS feature is enabled. |
Office365MailEnabled | Boolean | If feature is enabled. |
Office365MailQuota | Long | Quota value for Microsoft 365 Backup. |
OpenDirectEnabled | Boolean | If feature is enabled. |
OpenDirectQuota | Long | Quota value for OpenDirect. Only works on pre-v9.13 AhsayCBS. |
OracleBackupEnabled | Boolean | If feature is enabled. |
PostgreSQLBackupEnabled | Boolean | If feature is enabled. |
QnapEnabled | Boolean | If QNAP NAS feature is enabled. |
ShadowCopyEnabled | Boolean | If feature is enabled. |
ShadowProtectBackupEnabled | Boolean | If feature is enabled. |
VMwareBackupEnabled | Boolean | If feature is enabled. |
VMwareVMQuota | Long | Quota value for VMware. |
VMwareVMQuotaType | String | Quota type, either Guest VM or Socket. |
PasswordHistory
Key | Type | Description |
---|---|---|
PasswordLastModifiedTime | Long | Time password was last modified. |
HistoryList | Array | Array list of password history. |
MoveUserHomeRecord
Key | Type | Description |
---|---|---|
Dest | String | Destination User Home path. |
StartTime | Long | Millisecond time format. |
Source | String | Source User Home path. |
ProxySettings
Key | Type | Description |
---|---|---|
Type | String | Proxy type. |
Username | String | Proxy username used to login. |
Port | String | Port for the proxy. |
Enabled | Boolean | True / False |
Host | String | Hostname or IP of the proxy. |
Password | String | Password used to login to the proxy. |
RoutineJobsSettings
Key | Type | Description |
---|---|---|
QuotaRemindPercentage | Long | Backup quota reminder to user if backup quota is over a certain percentage. |
InactiveReportLastSentTime | Long | Time when last inactive report was sent. |
SecuritySettings
Key | Type | Description |
---|---|---|
UserLockSettings | Object | See UserLockSettings. |
Id | String | ID of the user. |
LastFailureTime | Long | Time of last failure. |
LockedTime | Long | Time user has been locked. |
LoginFailureCount | Long | Number of failed logins. |
PhoneList | Array | Array list of registered phones. |
Id | Long | ID of phone. |
Verified | Boolean | True / False |
VerifiedTime | Long | Time phone number was verified. |
PhoneNumber | Long | Phone number. |
CountryCode | Long | Country code of the phone number. |
Enable | Boolean | True / False |
SendLimitSettings | Object | List of setting for sending limit. |
LastSendTime | Long | Time last sent. |
SendCount | Integer | Number of times. |
RecoverySettings | Object | List of settings for recovery |
Token | String | Special key for recovery of user account. |
ExpiryTime | Long | Time limit when token is valid. |
TotalStatistics
Key | Type | Description |
---|---|---|
RetentionAreaUncompressedSize | Long | Uncompressed size of Retention Area. |
DataAreaFileCount | Integer | File count of Data Area. |
DataAreaUncompressedSize | Long | Uncompressed size of Data Area. |
DataAreaCompressedSize | Long | Compressed size of Data Area. |
RetentionAreaCompressedSize | Long | Compressed size of Retention Area. |
RetentionAreaFileCount | Integer | File count of Retention Area. |
TotalRecycleBinUncompressedSize | Long | Total uncompressed size all the user's backup sets in recycle bin. |
TotalRecycleBinCompressedSize | Long | Total compressed size all the user's backup sets in recycle bin. |
TotalRecycleBinFileCount | Long | Total file count of all the user's backup sets in recycle bin. |
UserLockSettings
Key | Type | Description |
---|---|---|
LastFailureTime | Long | Time of last failure. |
LockedTime | Long | Time user has been locked. |
LoginFailureCount | Integer | Number of failed logins. |
UserSuspendSettings
Key | Type | Description |
---|---|---|
Enabled | Boolean | True / False |
Date | Long | Timestamp in millisecond time format. |
windowsEventLogSettings
Key | Type | Description |
---|---|---|
Enabled | Boolean | True / False |
LogProfile | Boolean | True / False |
LogServices | Boolean | True / False |
LogUtilities | Boolean | True / False |
LogBackup | Boolean | True / False |
LogError | Boolean | True / False |
LogSoftwareUpdate | Boolean | True / False |
LogReport | Boolean | True / False |
LogLoginLogout | Boolean | True / False |
LogInfo | Boolean | True / False |
LogBuy | Boolean | True / False |
LogLicense | Boolean | True / False |
LogWarn | Boolean | True / False |
LogRestore | Boolean | True / False |
ModuleUsage
Key | Type | Description |
---|---|---|
MSExMailbox | Long | Usage of MSExMailbox module license. |
MSHyperVVM | Long | Usage of MSHyperVVM module license. |
MSVMwareVM | Long | Usage of MSVMwareVM module license. |
Office365Mail | Long | Usage of Office365Mail module license. |
HostCount | Long | Usage of OBM / ACB license. |
Example
INPUT
{
"SysUser":"system",
"SysPwd":"system1",
"LoginName":"obm2"
}
OUTPUT
{
"Status":"OK",
"Data":{
"Timezone":"1098",
"ClientRunVersion":"",
"Owner":"",
"HostCount":1,
"SoftwareUpdateSettings":{
"ReadOnly":false,
"Enabled":true,
"Id":""
},
"ModuleSettings":{
"MobileQuota":0,
"VMwareVMQuotaType":"GUESTVM",
"VMwareVMQuota":0,
"MobileEnabled":false,
"DeltaMergeEnabled":false,
"MSExchangeMailboxBackupEnabled":false,
"DeduplicationEnabled":false,
"MariaDBBackupEnabled":false,
"OracleBackupEnabled":false,
"QnapEnabled":false,
"MSExchangeBackupEnabled":false,
"OpenDirectEnabled":false,
"VMwareBackupEnabled":false,
"InFileDeltaEnabled":false,
"MSHyperVVMQuota":0,
"MySQLBackupEnabled":false,
"MobileV2Quota":0,
"LotusDominoBackupEnabled":false,
"OpenDirectQuota":0,
"MobileV2Enabled":false,
"ReadOnly":false,
"Office365MailQuota":0,
"MSHyperVVMQuotaType":"GUESTVM",
"NasClientEnabled":false,
"MSSQLBackupEnabled":false,
"MSExchangDAGServerQuota":0,
"ShadoeProtectBackupEnabled":false,
"MSWindowsSystemStateBackupEnabled":false,
"MSHyperVBackupEnabled":false,
"ShadowCopyEnabled":false,
"LotusNotesBackupEnabled":false,
"Id":"",
"Office365MailEnabled":false,
"CDPEnabled":false,
"MSExMailboxQuota":0,
"MSWindowsSystemBackupEnabled":false
},
"PasswordHistory":{
"ReadOnly":false,
"HistoryList":[],
"PasswordLastModifiedTime":1687069108460,
"Id":""
},
"RunDirectQuotaEnabled":false,
"Name":"obm2",
"AccessToken":"E1C9029954184F92B858280B9A6A3EBAA4F8809CA3E441C198ED5C2DE57918C3",
"UserHome":"C:\\Program Files\\AhsayCBS\\user\\obm2",
"LastSuccessfulLoginInfo":null,
"WindowsEventLogSettings":{
"ReadOnly":false,
"LogLoginLogout":false,
"LogInfo":false,
"LogLicense":false,
"Enabled":false,
"LogUtilities":false,
"LogError":false,
"LogServices":false,
"Id":"",
"LogSoftwareUpdate":false,
"LogProfile":false,
"LogRestore":false,
"LogBackup":false,
"LogWarn":false,
"LogBuy":false,
"LogReport":false
},
"UserSuspendSettings":{
"ReadOnly":false,
"Enabled":false,
"Id":"",
"Date":0
},
"Status":"ENABLE",
"ReadOnly":false,
"LockedByMFA":false,
"OpenDirectUsageCount":0,
"EncodedName":"obm2",
"MobileUserID":null,
"Updated":false,
"SavePassword":false,
"BackupSetIdList":[],
"Hostname":"jcvm.com",
"MailboxUsage":0,
"TrialDays":2592000000,
"DoubleEncodedName":"obm2",
"LastClientLoginTime":-1,
"PlanAmount":-1,
"UploadEncryptionKey":false,
"GroupPolicySettings":{
"ReadOnly":false,
"UserGroupIDList":[-1],
"ExcludeNetworkShare":false,
"GroupQuota":0,
"Id":"",
"UserGroupQuota":0,
"FileSizeLimit":0
},
"YearPlan":null,
"LastShowingLicViolationTime":-1,
"Id":"1687069108461",
"RunDirectQuota":1,
"File":"C:\\Program Files\\AhsayCBS\\con\\users.xml",
"MobileAuthenticationSettings":{
"Enable":false,
"LastCountryCode":""
},
"ForgotPasswordSettings":{
"ReadOnly":false,
"Token":"",
"RequestTime":-1,
"Id":"",
"ResetTime":-1
},
"LdapSettings":{
"ReadOnly":false,
"LdapUser":false,
"LastDeleteTime":0,
"LastDisableTime":0,
"Id":"",
"FirstAuthFailureTime":-1
},
"TopDir":"C:\\Program Files\\AhsayCBS\\user",
"EnableAUA":true,
"ClientType":"OBM",
"RegistrationDate":1687069108460,
"QuotaList":[
{
"DestinationKey":"OBS",
"Quota":5368091200,
"DestinationName":"AhsayCBS",
"Enabled":true
},
{
"DestinationKey":"-1687068833705",
"Quota":0,
"DestinationName":"Local-1",
"Enabled":false
},
{
"DestinationKey":"-1686815201815",
"Quota":0,
"DestinationName":"AhsayCBS-1",
"Enabled":false
}
],
"ProxySettings":{
"ReadOnly":false,
"Type":"",
"Username":"",
"Port":"",
"Enabled":false,
"Host":"",
"Id":"",
"Password":""
},
"HostQuotaEnabled":false,
"AdGroups":[1],
"ComputerNameDirList":null,
"SecuritySettings":{
"UserLockSettings":{
"LockedTime":-1,
"LastFailureTime":-1,
"LoginFailureCount":0
},
"PhoneList":[],
"Enable":false,
"SendLimitSettings":{
"LastSendTime":-1,
"SendCount":0
},
"RecoverySettings":{
"Token":"",
"ExpiryTime":-1
}
},
"AdGroup":"1",
"SuspendPaidUserDate":"19700101",
"MobileBackupSettings":{
"DeviceList":[]
},
"HostSet":{
"":""
},
"Locked":false,
"CloudbackoGoDriveEnabled":false,
"Language":"en",
"ServerSettings":null,
"HomeDir":"C:\\Program Files\\AhsayCBS\\user\\obm2",
"Bandwidth":0,
"StorageQuota":100,
"class":"com.ahsay.obs.core.cxp.User",
"HashedPassword":true,
"SecurityIdentifier":"",
"Notes":"",
"Password":"BSJEajFurvvTdkh1V4+1Asgw6wjjIpkgK3rJ00y5S87B0=",
"RemovingLogs":null,
"NewBSetName":"BackupSet-0",
"ImportDate":0,
"UserLockSettings":{
"LockedTime":-1,
"LastFailureTime":-1,
"LoginFailureCount":0
},
"TotalStatistics":{
"TotalRecycleBinUncompressedSize":0,
"DataAreaFileCount":0,
"TotalRestoreCompressedSize":0,
"TotalRecycleBinFileCount":0,
"LastBackupCompressedSize":0,
"DataAreaCompressedSize":0,
"LastBackupUncompressedSize":0,
"RetentionAreaFileCount":0,
"RetentionAreaUncompressedSize":0,
"DataAreaUncompressedSize":0,
"TotalUploadCompressedSize":0,
"LastBackupFileCount":0,
"TotalUploadFileCount":0,
"TotalRestoreFileCount":0,
"TotalRecycleBinCompressedSize":0,
"RetentionAreaCompressedSize":0
},
"QuotaType":"PER_DESTINATION_QUOTA",
"V6File":"C:\\Program Files\\AhsayCBS\\user\\obm2\\db\\Profile.xml",
"RoutineJobSettings":{
"ReadOnly":false,
"QuotaRemindPercentage":0,
"Id":"",
"InactiveReportLastSentTime":-1
},
"LongLoginName":"obm2",
"ContactList":[
{
"ReadOnly":false,
"Company":"",
"Phone1":"",
"Email":"obm2@example.com",
"Address":"",
"EmailCertificate":"",
"Phone2":"",
"EncryptEmail":false,
"Website":"",
"Id":"1687069108462",
"Name":""
}
],
"EmailReportSettings:{
"SendBkpRpt":false,
"ReadOnly":false,
"Usage":0,
"Email":"",
"ReportSenderEmail":"",
"SmtpAuthUser":"",
"Enabled":false,
"SendBkpRptMode":"",
"SmtpHostName":"",
"MissedBkpInterval":0,
"SmtpProtocol":"",
"Id":"",
"SmtpPort":"",
"SendMissedBkpRpt":false,
"SendStorageAlert":false,
"SmtpAuthPwd":""
},
"LastLoginTime":0,
"Type":"PAID",
"UsedHostQuota":0,
"Alias":"",
"UserId":"obm2",
"FullName":null,
"PreV7":false,
"TrialExpiryDate":0,
"MoveUserHomeRecord":null,
"HostQuota":1,
"HostInfo":""
}
}