Get Recovery Points From Source VM/Instance

Returns recovery points from a source VM/instance/backup object.

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

{
curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data "{
        "action": "JobManagement",
        "method": "getSavepoints",
        "data": ["VM-385", null],
        "type": "rpc",
        "tid": 0
}

Request Fields

Field	Type	Value(s)
action	string	JobManagement
method	string	getSavepoints
data	array	See the data table below
type	string	rpc
tid	int	0

data

Field	Type	Description
vid	string	VID of the source item.
limit	int	Optional. Max count.

Response Sample

curl

Copy

{
   "action":"JobManagement",
   "method":"getSavepoints",
   "tid":"0",
   "type":"rpc",
   "message":null,
   "where":null,
   "cause":null,
   "data":[
      {
         "id":97,
         "uuid":"Recovery point Wed, 08 Apr 2020 at 11:24:34 (UTC +07:00)",
         "added":"2020-04-08T11:24:34.543+07:00",
         "addedRelative":-4363204,
         "checkState":"NEUTRAL",
         "checked":"null",
         "lockedShared":false,
         "lockedExclusive":false,
         "lockReasons":[

         ],
         "latest":true,
         "hasDependentSp":false,
         "lastUncorruptedRemaining":true,
         "lastCorruptedRemaining":false,
         "isAccessible":true,
         "hasRootDisk":false,
         "type":"FULL",
         "consumed":null,
         "protectedPolicy":null,
         "expired":null,
         "userPrincipalName":null,
         "belongIncrementalWithFullRepo":false
      }
   ]
}

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	string	See the data table below

data

Field	Type	Description
id	long	Savepoint ID
uuid	string	Savepoint UUID
added	string	Date and time when the savepoint was added. Format: YYYY-MM-DDTHH:MM:SS.SSSZ
addedRelative	long	Milliseconds between created time and the current time.
checkState	string	The state of the savepoint. Possible values: NEUTRAL, VERIFIED, CORRUPTED
checked	string	Last time verify the savepoint.
lockedShared	boolean	true if multiple read operations cannot run on the same savepoint at the same time.
lockedExclusive	boolean	true if multiple updates cannot be made to the savepoint at the same time.
lockReasons	array	Lock reasons.
latest	boolean	If true the savepoint is the latest.
hasDependentSp	boolean	If true the savepoint type is INCREMENTAL and dependent on the previous savepoint.
lastUncorruptedRemaining	boolean	true if the savepoint is the last uncorrupted.
lastCorruptedRemaining	boolean	true if the savepoint is the last corrupted.
isAccessible	boolean	true if the savepoint is accessible.
hasRootDisk	boolean	AWS-specific: true if savepoint has a Root volume.
type	string	Savepoint type. Possible values: INCREMENTAL, FULL, UNKNOWN
consumed	long	Specific for incremental with full backups repository. The savepoint size in bytes.
protectedPolicy	string	The protected policy config for the savepoint. Possible values: USE_JOB_RETENTION, KEEP_FOREVER, PROTECT_UNTIL
expired	string	Time and date of the expired savepoint. Format: YYYY-MM-DDTHH:MM:SS.SSSZ
userPrincipalName	string	Specific for Office 365 savepoint. Email of the user.
belongIncrementalWithFullRepo	boolean	true if the savepoint resides on the incremental with full backups repository.