
This is an archive version of the document. To get the most up-to-date information, see the
current version.
(GET) /vmRestorePoints
Returns a resource representation of a collection of restore points for separate VMs in backup files.
To get a list of restore points for separate VMs, you need to send the GET HTTP request to the URL of the /vmRestorePoints resource.
HTTP Request
GET http://<Enterprise-Manager>:9399/api/vmRestorePoints |
Request Headers
The request contains the following headers:
Header | Required | Description |
X-RestSvcSessionId | True | The request requires authorization. In the header, the client must send a session ID copied from the server reply to the request creating a new logon session. To learn more, see Authentication and Security. |
Request Body
None.
Query Parameters
None.
The server returns the following response to the client.
Response Codes
A successfully completed operation returns response code 200 Success.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTP headers.
Header | Description |
Content-length | The length of the response body. |
Content-type | The media type and syntax of the request body message: application/xml. |
Response Body
In the response body, Veeam Backup Enterprise Manager returns a representation of the /vmRestorePoints resource collection.
The example below returns a list of all restore points for backups created on Veeam backup servers connected to Veeam Backup Enterprise Manager.
Request: GET http://localhost:9399/api/vmRestorePoints Request Header: X-RestSvcSessionId NDRjZmJkYmUtNWE5NS00MTU2LTg4NjctOTFmMDY5YjdjMmNj Response: 200 Success Response Body: <EntityReferences xmlns="http://www.veeam.com/ent/v1.0"> <Ref Type="VmRestorePointReference" Href="http://localhost:9399/api/vmRestorePoints/2c29730b-cb73-46f5-883f-0f471268fc43" Name="oracle@2014-10-09 07:07:55" UID="urn:veeam:VmRestorePoint:2c29730b-cb73-46f5-883f-0f471268fc43"> <Links> <Link Rel="Up" Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/ce15a8c7-aa49-495e-b05b-ee3398c91018" Name="srv02.veeam.local" /> <Link Rel="Up" Type="RestorePointReference" Href="http://localhost:9399/api/restorePoints/391bd194-fcf4-4ce3-a507-27447bc0a4cd" Name="Oct 9 2014 7:07AM" /> <Link Rel="Alternate" Type="VmRestorePoint" Href="http://localhost:9399/api/vmRestorePoints/2c29730b-cb73-46f5-883f-0f471268fc43?format=Entity" Name="oracle@2014-10-09 07:07:55" /> </Links> </Ref> <Ref Type="VmRestorePointReference" Href="http://localhost:9399/api/vmRestorePoints/5fa68dec-cad0-47bc-bc33-0fe18b5d5e4d" Name="sql02@2014-10-13 09:52:41" UID="urn:veeam:VmRestorePoint:5fa68dec-cad0-47bc-bc33-0fe18b5d5e4d"> <Links> <Link Rel="Up" Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/ce15a8c7-aa49-495e-b05b-ee3398c91018" Name="srv02.veeam.local" /> <Link Rel="Up" Type="RestorePointReference" Href="http://localhost:9399/api/restorePoints/09a3bd4d-7d34-47f2-89e4-b050841dd393" Name="Oct 13 2014 9:51AM" /> <Link Rel="Alternate" Type="VmRestorePoint" Href="http://localhost:9399/api/vmRestorePoints/5fa68dec-cad0-47bc-bc33-0fe18b5d5e4d?format=Entity" Name="sql02@2014-10-13 09:52:41" /> </Links> </Ref> <Ref Type="VmRestorePointReference" Href="http://localhost:9399/api/vmRestorePoints/1fe097f7-f629-4773-9eee-1231056cf1e8" Name="sql02@2014-10-13 09:46:26" UID="urn:veeam:VmRestorePoint:1fe097f7-f629-4773-9eee-1231056cf1e8"> <Links> <Link Rel="Up" Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/ce15a8c7-aa49-495e-b05b-ee3398c91018" Name="srv02.veeam.local" /> <Link Rel="Up" Type="RestorePointReference" Href="http://localhost:9399/api/restorePoints/0a3adbad-74b7-4db2-ba76-e091e0332114" Name="Oct 13 2014 9:45AM" /> <Link Rel="Alternate" Type="VmRestorePoint" Href="http://localhost:9399/api/vmRestorePoints/1fe097f7-f629-4773-9eee-1231056cf1e8?format=Entity" Name="sql02@2014-10-13 09:46:26" /> </Links> </Ref> <Ref Type="VmRestorePointReference" Href="http://localhost:9399/api/vmRestorePoints/552f7045-f06c-4b90-9eb1-21549bf8578a" Name="fileserver03@2014-10-05 08:29:19" UID="urn:veeam:VmRestorePoint:552f7045-f06c-4b90-9eb1-21549bf8578a"> <Links> <Link Rel="Up" Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/ce15a8c7-aa49-495e-b05b-ee3398c91018" Name="srv02.veeam.local" /> <Link Rel="Up" Type="RestorePointReference" Href="http://localhost:9399/api/restorePoints/a398100b-8b07-436f-b2e7-d92804a49625" Name="Oct 5 2014 8:28AM" /> <Link Rel="Alternate" Type="VmRestorePoint" Href="http://localhost:9399/api/vmRestorePoints/552f7045-f06c-4b90-9eb1-21549bf8578a?format=Entity" Name="fileserver03@2014-10-05 08:29:19" /> </Links> </Ref> ... </EntityReferences> |