List file versions

Retrieve the list of versions of the file.

Path Parameters

search_result_id string required
Performs the operation on the file with the specified ID.

Query Parameters

limit int64
Limits the size of the response on each page to the specified number of items.
start string
Sets the page token used to browse the collection. Leave this parameter empty to get the first page. Other pages can be traversed using HATEOAS links.

Responses

200
default

Success

application/api.clumio.backups-files=v1+json

Schema
Example (from schema)

Schema

_embedded object
Embedded responses related to the resource.
items object[]
A collection of requested items.
_links object
URLs to pages related to the resource.
restore-files object
A resource-specific HATEOAS link.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
backup_id string
The Clumio-assigned ID of the backup.
filesystem_id string
The Clumio-assigned ID of the filesystem within which to restore the file. Use GET /backups/files/search/{search_result_id}/versions to fetch the value.
modified_timestamp string
The timestamp of the last time the file was modified. Represented in RFC-3339 format.
path string
The path of the file to be restored. Use GET /backups/files/search to fetch the value.
size int64
The size of the file in bytes.
start_timestamp string
The timestamp of when the backup associated with this file started. Represented in RFC-3339 format.
_links object
URLs to pages related to the resource.
_first object
The HATEOAS link to the first page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_next object
The HATEOAS link to the next page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_self object
The HATEOAS link to this resource.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
current_count int64
The number of items listed on the current page.
limit int64
The maximum number of items displayed per page in the response.
start string
The page token used to get this response.

{
  "_embedded": {
    "items": [
      {
        "_links": {
          "restore-files": {
            "href": "string",
            "templated": true,
            "type": "string"
          }
        },
        "backup_id": "string",
        "filesystem_id": "string",
        "modified_timestamp": "string",
        "path": "string",
        "size": 0,
        "start_timestamp": "string"
      }
    ]
  },
  "_links": {
    "_first": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "_next": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "_self": {
      "href": "string",
      "templated": true,
      "type": "string"
    }
  },
  "current_count": 0,
  "limit": 0,
  "start": "string"
}

Error

application/json

Schema
Example (from schema)

Schema

errors object[]
A list of errors encountered during runtime.
error_code uint32
error_message string
The reason for the error.

{
  "errors": [
    {
      "error_code": 0,
      "error_message": "string"
    }
  ]
}

List file versions​

List file versions