Create a backup from a cloud volume

POST/v1/cloud_block_storage/backups

To create a new backup, send a POST request to the /v1/cloud_block_storage/backups endpoint. Specify an ID of a necessary volume and give a name to a copy in the query parameters.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

FieldDetails
volume_id
string

A unique identifier of a volume. See a request to list volume IDs in the Cloud Volume section.

name
string

A name of a backup.

incremental?
boolean

An incremental backup is a copy that contains only a part of data that was modified. To make an incremental backup, fill this parameter with the true value.

force?
boolean

If this parameter has the false value, a backup will be created only for a volume with the available status. In the case of the true value, volumes with the available or in-use statuses are backed up. See more details about volume statuses in the Cloud Volume section.

labels?
object

Specify labels you want to attach to the resource. Refer to the Labels section for more details.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/cloud_block_storage/backups" \  -H "Content-Type: application/json" \  -d '{    "volume_id": "lNbWJayg",    "name": "baackup",    "labels": {      "environment": "production",      "service": "my-web-app",      "example.com/project": "my-project",      "example.com/owner": "my-team"    }  }'
{  "id": "MvbmOeYA",  "openstack_uuid": null,  "openstack_volume_uuid": "044432a0-71a2-4325-b892-f0810ccbe964",  "region_id": 0,  "region_code": "NL01",  "name": "baackup",  "size": 1,  "status": "pending",  "labels": {    "environment": "production",    "service": "my-web-app",    "example.com/project": "my-project",    "example.com/owner": "my-team"  },  "created_at": null}