Endpoint

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

GET

Returns the byte ranges of a file whose contents differ between two snapshots. Each entry's `type` field reports what's in the newer snapshot at that range: DATA or HOLE.

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_v2",
  "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"
          }
        }
      }
    }
  }
}