Expose a server backup
POST/api/v3/servers/:server_id/backups/exhibitions
Required scopes: server:write
Exposes a backup of the virtual machine (backup_id, one of GET /api/v3/servers/{server_id}/backups/exhibitions) as an additional disk, to read its files without restoring it: it replaces the backup exposed before, the server may restart, and the operation goes on in the background as the returned Task. Exposed backups are removed after a few days, or with DELETE /api/v3/servers/{server_id}/backups/exhibitions. 409 for a physical server or a virtual machine that is not on oVirt, while the exposed backups are being deleted, while the server is not ready, its service is not active or is under maintenance, or another operation does not allow it
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Accepted: the operation goes on in the background, as the returned Task
Response Headers
URL of the Task: /api/v3/tasks/{task_id}. Reading it requires the purchases:read scope
The request is not valid: error 1000 with the errors for each field in meta.errors, error 1001 (or 1) for other invalid input
The access token is missing, invalid, expired or revoked (error 1100): request a new token and retry once
The access token is valid but not enough: missing scope (error 1101), token for the other API (error 1102), missing permission, feature not included in the plan, operation not available to sub-accounts, internal API without administrator privileges or IP address not allowed (error 1601). A new token does not change the result
The resource does not exist or does not belong to the account (error 1200)
The request conflicts with a business rule or with the current state of the resource (error 1400)
Too many requests (error 1300): retry after the seconds in the Retry-After header
Response Headers
Seconds to wait before retrying
Unexpected server error (error 1500)