Get a List of Missing Recovery Points

Product version: 10.11

Last modified: 31 July 2024

Returns a list of all missing recovery points for a backup repository.

To bulk remove missing recovery points, note this request's response and proceed to Bulk Remove Recovery Points.

Endpoint

https://<Director_IP_address>:4443/c/router

Tenant Endpoint

For tenants of the multi-tenant product the endpoint must be:

https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Request Example

curl

Copy

{
    "action": "BackupManagement",
    "method": "collectSavepointRemoveList",
    "data": [{
            "removeOption": "MISSING_SAVEPOINTS",
            "olderThanDays": null,
            "backupRepositoryId": 4
        }
    ],
    "type": "rpc",
    "tid": 1
}

Request Fields

Field	Type	Value(s)
`action`	string	`BackupManagement`
`method`	string	`collectSavepointRemoveList`
`data`	array	The filtration parameters (see below)
`type`	string	`rpc`
`tid`	int	1

Data

Field	Type	Description
`removeOption`	string	Possible values: MISSING_SAVEPOINTS, SAVEPOINTS_OLDER_THAN, CORRUPTED_SAVEPOINTS, NO_JOB_SAVEPOINTS_OLDER_THAN
`backupRepositoryId`	int	ID of the backup repository containing the recovery points

Response Sample

curl

Copy

{
  "action": "BackupManagement",
  "method": "collectSavepointRemoveList",
  "tid": "1",
  "type": "rpc",
  "message": null,
  "where": null,
  "cause": null,
  "data": {
    "items": [
      {
        "vid": "SAVEPOINT-555",
        "parentVid": "BACKUP_OBJECT-115",
        "name": "4MB Small Linux test CanRm-replica (1)",
        "timestamp": "2024-06-25T14:09:39.023+07:00",
        "jobName": "NJM-111590 - Maintain",
        "jobType": "Backup copy job",
        "size": "0.0 KB",
        "savepointType": "Incremental",
        "scheduleName": "Manual run",
        "protectedUntil": "Mon, 08 Jul 2024 at 17:37 (UTC +07:00)"
      }
    ],
    "totalDependSavepoints": 0
  }
}

Response Fields

Field	Value	Description
`message`	string	Message if the request failed
`where`	string	Reference to the method where the problem occurred
`cause`	string	Cause of failure
`data`	array	Parameters of the recovery points (see below)

data

Field	Value	Description
`items`	array	Recovery point list (see below)
`totalDependSavepoints`	int	Number of recovery points dependent on the listed missing recovery points

data.items

Field	Value	Description
`vid`	string	Recovery point VID
`parentVid`	string	Backup object VID
`name`	string	Backup object name
`timestamp`	`DateTime`	Date and time the recovery point was created
`jobName`	string	Job name
`jobType`	string	Job type
`size`	`number`	Recovery point size
`savepointType`	string	Savepoint type. Possible values: INCREMENTAL, FULL, UNKNOWN
`scheduleName`	string	Schedule display name
`protectedUntil`	string	Until the recovery point is protected