Skip to main content

GetBackupJobReport

July 21, 2025

This API can be used to retrieve a detailed report of a specific backup job.

The settings can be found on the AhsayCBS web console at:

  • Monitoring > Backup / Restore Logs > Backup Jobs

URL

https://CBS.EXAMPLE.COM/obs/api/json/GetBackupJobReport.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 Username of the backup user.
Owner String Owner of the backup user.
BackupSetID String ID of the backup set. Obtainable by calling the GetBackupSet API.
DestinationID String For backup run by AhsayOBM v6 or older, this parameter can be omitted. For backup run by AhsayOBM v7, this parameter must be provided to get correct result.
BackupJobID String ID of the backup job. Obtainable by calling the GetBackupSet API.
Cdp Boolean True / False
Return Values
Key Type Description
Status String "OK" or "Error"
Data String See JSON Objects
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

Report

Key Type Description
ID String ID of the report.
StartTime String In yyyy-MM-dd HH:mm:ss format.
EndTime String In yyyy-MM-dd HH:mm:ss format.
BackupJobStatus String Job status. BS_STOP_SUCCESS if successful backup. Error varies if the backup failed.
NumOfWarnEntries Long Number of warning entries.
NumOfErrorEntries Long Number of error entries.
NumOfNewFiles Long Number of new files.
TotalNewFilesSize Long Total size of new files.
TotalUnzipNewFilesSize Long Total size of unzipped new files.
NewFilesZipRatio Long Ratio of zipped new files.
NumOfUpdatedFiles Long Number of updated files.
TotalUpdatedFilesSize Long Total size of updated files.
TotalUnzipUpdatedFilesSize Long Total size of unzipped updated files.
UpdatedFilesZipRation Long Ratio of zipped updated files.
NumOfUpdatedPermissionFiles Long Number of updated permission files.
TotalUpdatedPermissionFilesSize Long Total size of updated permission files.
TotalUnzipUpdatedPermissionFilesSize Long Total size of unzipped updated permission files.
UpdatedPermissionFilesZipRatio Long Ratio zipped updated permission files.
NumOfDeletedFiles Long Number of deleted files.
TotalDeletedFilesSize Long Total size of deleted files.
TotalUnzipDeletedFilesSize Long Total size of unzipped deleted files.
DeletedFilesZipRatio Long Ratio of zipped deleted files.
NumOfMovedFiles Long Number of moved files.
TotalMovedFilesSize Long Total size of moved files.
TotalUnzipMovedFilesSize Long Total size of unzipped moved files.
MovedFilesZipRatio Long Ratio of zipped moved files.
SuccessDatabase Long This key does not exist in VM backup.
MissedDatabase Long This key does not exist in VM backup.
SuccessVirtualMachine Long This key exists in VM backup.
MissedVirtualMachine Long This key exists in VM backup.
SuccessPublicFolder Long Public folder of successful jobs.
MissedPublicFolder Long Public folder of missed jobs.
info Array of InfoLog See InfoLog.
new Array of FileLog See FileLog.
upd Array of FileLog See FileLog.
pmt Array of FileLog See FileLog.
del Array of FileLog See FileLog.
mov Array of MoveLog See MoveLog.
cpy Array of FileLog See FileLog.
DedupeEnabled Boolean Whether deduplication is enabled or not.
DedupeOriginalSize Long Size of deduplication.
DedupeSaving Long Difference between the original size of dedupe and current dedupe size.

InfoLog

Key Type Description
Type String Type of log.
LogType String Type of log
Timestamp String In yyyy/MM/dd HH:mm:ss format.
Message String Description of log.

FileLog

Key Type Description
Type String Type of log.
LastModified String In yyyy/MM/dd HH:mm:ss format.
Name String Name of the log.
FileSize Long Size of files.
UnzipFilesSize Long Size of unzipped files.
Ratio String Ratio of files.

MoveLog

Key Type Description
Type String Type of log.
LastModified String In yyyy/MM/dd HH:mm:ss format.
FromFile String Source file.
ToFile String Destination file.
FileSize Long Size of files.
UnzipFilesSize Long Size of unzipped files.
Ratio String Ratio of files.
Example

INPUT

{
	"SysUser":"system",
	"SysPwd":"system1",
	"LoginName":"obm",
	"Owner":"",
	"BackupSetID":"1692320086130",
	"DestinationID":"-169224967005",
	"BackupJobID":"2024-08-23-10-00-36",
	"Cdp":"false"
}

OUTPUT

{
    "Status":"OK",
	"Data":{
	     "ID":"2024-06-26-13-24-35",
         "FromIp":"10.3.121.64",
	     "SuccessDatabase":"",
	     "MissedDatabase":"",
	     "SuccessPublicFolder":"",
	     "MissedPublicFolder":"",
	     "Logs":[
		      {
			       "Type":"start",
			       "LogType":"start",
			       "Timestamp":"2024/06/26 13:24:37",
			       "Message":"Start [AhsayOBM v 9.11.0.0]"
		      },
		      {
			       "Type":"info",
			       "LogType":"info",
			       "Timestamp":"2024/06/26 13:24:38",
			       "Message":"Using Temporary Directory C:\\Users\\Administrator\\temp\\1687755057644\\OBS@1687755083984"			
		      },
		      {
			       "Type":"info",
			       "LogType":"info",
			       "Timestamp":"2024/06/26 13:24:40",
			       "Message":"Index file does not exist in the destination backup job folder \"null\""			
		      }
	     ],
	     "NumOfNewFiles":1169,
	     "NumOfNewDirCount":24,
	     "NumOfNewLinkDirCount":3,
	     "NumOfNewLinkFileCount":0,
	     "NumOfDeletedDirCount":0,
	     "NumOfDeletedLinkFileCount":0,
	     "TotalNewFilesSize":6827033,
	     "TotalUnzipNewFilesSize":10268480,
	     "NewFilesZipRatio":"33%",
	     "NumOfUpdatedFiles":0,
	     "TotalUpdatedFilesSize":0,
	     "TotalUnzipUpdatedFilesSize":0,
	     "UpdatedFilesZipRatio":"0%",
	     "NumOfUpdatedPermissionFiles":0,
	     "TotalUpdatedPermissionFilesSize":0,
	     "TotalUnzipUpdatedPermissionFilesSize":0,
	     "UpdatedPermissionFilesZipRatio":"0%",
	     "NumOfDeletedFiles":0,
	     "TotalDeletedFilesSize":0,
	     "TotalUnzipDeletedFilesSize":0,
	     "DeletedFilesZipRatio":"0%",
	     "NumOfMovedFiles":0,
	     "TotalMovedFilesSize":0,
	     "TotalUnzipMovedFilesSize":0,
	     "MovedFilesZipRatio":"05",
	     "NumOfCopiedFiles":0,
	     "TotalCopiedSize":0,
	     "TotalUnzipCopiedFilesSize":0,
	     "CopiedFilesZipRatio":"0%",
	     "StartTime":"2024-06-26 13:24:37",
	     "EndTime":"2024-06-26 13:24:58",
	     "BackupJobStatus":"BS_STOP_SUCCESS",
	     "NumOfWarnEntries":0,
	     "NumOfErrorEntries":0,
	     "DedupeEnabled":true,
	     "DedupeOriginalSize":2384,
	     "DedupeSaving":0
	}
}