storage

Create on-demand backup

Creates a point-in-time backup of private normal block storage. The operation is asynchronous: the source block storage is backuping while the backup is created, and the returned backup remains in maintenance until it is ready.

post/1.3/storage/{uuid}/backup

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/storage/{uuid}/backup
  • Auth: HTTP bearer

Path parameters

uuidstring uuid required

Universally unique identifier

Example:0414e0d7-4436-4037-9dd8-6eaf47dce599

Block storage UUID

Request body

Example request

{
  "storage": {
    "title": "Manually created backup"
  }
}

Response

On-demand backup created

Example response

{
  "storage": {
    "access": "private",
    "created": "2026-08-26T09:20:00Z",
    "encrypted": "yes",
    "labels": [
      {
        "key": "environment",
        "value": "production"
      }
    ],
    "license": 0,
    "origin": "01d4fcd4-e446-433b-8a9c-551a1284952e",
    "progress": "0",
    "servers": {
      "server": []
    },
    "size": 50,
    "state": "maintenance",
    "title": "Manually created backup",
    "type": "backup",
    "uuid": "016d343b-14de-4b61-91ca-433dd1ea6c47",
    "zone": "fi-hel1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.