Get List of Virtual Server Recovery Points

The get the list of virtual server recovery points, use the following request: 

GET /virtual_machines/:virtual_machine_id/backups/recovery_points.xml
GET /virtual_machines/:virtual_machine_id/backups/recovery_points.json

XML Request Example

curl -i -X GET -H 'Accept: application/xml' -H 'Content-type: application/xml' -u user:userpass --url http://onapp.test/virtual_machines/13/backups/recovery_points.xml

JSON Request Example

curl -i -X GET -H 'Accept: application/json' -H 'Content-type: application/json' -u user:userpass --url http://onapp.test/virtual_machines/13/backups/recovery_points.json

XML Output Example

<recovery_points type="array">
  <recovery_point>
    <resource_id type="integer">1</backup_resource_id>
    <created_at type="dateTime">2018-03-15T08:05:32+00:00</created_at>
    <id type="integer">3</id>
    <size type="integer">40</size>
    <state>built</state>
    <updated_at type="dateTime">2018-03-15T08:05:32+00:00</updated_at>
    <virtual_machine_id type="integer">13</virtual_server_id>
  </recovery_point>
  <recovery_point>...<recovery_point>
</recovery_points>

Where: 

recovery_point - the array of recovery point parameters

resource_id - the ID of the backup resource on which the backup is created

created_at - the date when the recovery point was created in the [YYYY][MM][DD]T[hh][mm][ss] format

id - the ID of the recovery point

size - the size of the backup in bytes from which the VS can be restored  

state - the status that indicates whether the backup is built

updated_at - the date when the recovery point was updated in the [YYYY][MM][DD]T[hh][mm][ss] format

virtual_machine_id - the ID of the virtual server 


Page History

v. 5.9

  • updated the following API requests: 

    • from GET /virtual_servers/:virtual_server_id/backups/recovery_points.xml to GET /virtual_machines/:virtual_machine_id/backups/recovery_points.xml

    • from GET /virtual_servers/:virtual_server_id/backups/recovery_points.json to GET /virtual_machines/:virtual_machine_id/backups/recovery_points.json