HP Matrix 7.2 KVM Private Cloud Backup and Restore

Table Of Contents
Restore REST API Overview
The restore REST API provides REST calls to upload a backup to the appliance, start a restore, and check the restore
status. These calls are summarized in the table below. The REST API calls to start a restore require a session ID for
authorization. The session ID is obtained by issuing the REST request to log in to the appliance as a user with the
"Infrastructure Administrator" role. The REST API calls to get restore status information do not require a session ID.
REST Call Request Headers Request Body
Response
Headers
Response
Body
Description
POST https://{appl}
/rest/backups/archi
ve
auth: session ID,
content-type:
multipart/form-data,
accept-language:
locale, accept-
content:
application/json, X-
API-Version: 1
Multipart form
data containing
the backup file
N/A
A backup
resource
that contains
the upload
status,
anuri for
restoring the
backup, and
other
information
about the
backup
Upload a
backup to the
appliance
POST https://{appl}
/rest/restores
auth: session ID,
accept-language:
locale, accept-
content:
application/json, X-
API-Version: 1
A json object that
contains two
elements. These
elements are
"type" with value
"RESTORE" and
"uriOfBackupToR
estore" set to
the uri returned
by the upload
request
N/A
A restore
resource
that contains
restore
status and
auri for
getting
restore
progress
information
Start restoring
an uploaded
backup
GET https://{appl}/
{uri}
accept-language:
locale, accept-
content:
application/json, X-
API-Version: 1
N/A N/A
A restore
resource
that contains
the current
restore
status and
progress
information
Get restore
progress
information
GET https://{appl}/
rest/restores
accept-language:
locale, accept-
content:
application/json, X-
API-Version: 1
N/A N/A
A
SimplePagin
atedCollecti
on that
contains the
last restore
resource
Get
information
about the last
restore or a
restore under
way
36