Recovery Media

The Recovery Media section defines a path and operation for downloading recovery media that is used for bare metal recovery.

Download Recovery Media

The HTTP GET request to the /api/v1/recoveryMedia/{taskId}/download endpoint downloads the Veeam Recovery Media ISO file produced by the task that was started with the Create Recovery Media Task for Discovered Entity or Create Recovery Media Task for Backup Object request. The task must have a Stopped state with a Success result.

Available to: Backup Administrator, Restore Operator. Also available to custom roles that have restore permissions.

SecurityBearer
Request
path Parameters
taskId
required
string <uuid>

ID of the recovery media task. To get the ID, run the Get All Tasks request or capture it from the start request response.

header Parameters
x-api-version
required
string
Default: 1.3-rev2

Version and revision of the client REST API. Must be in the following format: <version>-<revision>.

Responses
200

OK

400

Bad request. This error is related to POST/PUT requests. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.

404

Not found. No object was found with the path parameter specified in the request.

500

Internal server error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v1/recoveryMedia/{taskId}/download
Request samples
Response samples
application/json
{
  • "errorCode": "UnexpectedContent",
  • "message": "One or more request parameters are not valid."
}