Volumes /
Get volume backups
Get list of backups associated with a volume
Required permission
Project > Volumes > Backups > Read
Path parameters
projectId
string requiredID of the projectvolumeId
string requiredID of the volume
Query parameters
per_page
integerThe number of results to display per request. Maximum of 100 results per page.page
integerThe page number to access.cursor
stringThe cursor returned from the previous page of results, used to request the next page.
Response body
- {object}Response object.
data
[array] requiredResult data.- {object}
id
string requiredIdentifier for the backupname
string requireddescription
stringstatus
string requiredspec
{object}source
{object}type
stringsourceObject
{object}id
string requiredspec
{object}createdAt
stringtime of creationupdatedAt
stringtime of updatepagination
{object} requiredData about the endpoint pagination.hasNextPage
boolean requiredIs there another page of results available?cursor
stringThe cursor to access the next page of results.count
number requiredThe number of results returned by this request.
API
CLI
JS Client
GET /v1/projects/{projectId}/volumes/{volumeId}/backups
Example response
200 OK
The list of volume backups.
JSON
{
"data": [
{
"id": "example-backup"
}
],
"pagination": {
"hasNextPage": false,
"count": 1
}
}