Endpoint

/v2/snapshots/{newer_id}/changes-since/{older_id}/files/{ref}

GET

Returns a list of changed byte ranges between two snapshots of a regular file. The list includes new, modified, and deallocated regions of the file's contents.

Parameters

Name Description Required
newer_id Newer snapshot Yes
older_id Older snapshot Yes
ref The file ID or the absolute path to the file system object. File IDs can be found in the id field of responses of APIs that return file attributes. You must URL-encode the paths. The APIs & Tools page in the Qumulo Core Web UI URL-encodes the paths. Yes
after Return entries after the given key (keys are returned in the paging object) No
limit Return no more than this many entries; the system may choose a smaller limit. No

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "api_snapshot_file_diff",
  "type": "object",
  "properties": {
    "entries": {
      "type": "array",
      "items": {
        "description": "entries",
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "FILE_REGION_DATA",
              "FILE_REGION_HOLE"
            ],
            "description": "The type of content in the changed region of the file in the newer snapshot. The region may contain either data a hole.:\n * `FILE_REGION_DATA` - FILE_REGION_DATA,\n * `FILE_REGION_HOLE` - FILE_REGION_HOLE"
          },
          "offset": {
            "description": "The starting offset of the changed region in bytes.",
            "type": "string"
          },
          "size": {
            "description": "The size of the changed region in bytes.",
            "type": "string"
          }
        }
      }
    }
  }
}