Endpoint

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

GET

Returns the operations that transform the older snapshot's file contents into the newer snapshot's, at byte-range granularity. Each entry's `op` field is CREATE, MODIFY, or DELETE.

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_v3",
  "type": "object",
  "properties": {
    "entries": {
      "type": "array",
      "items": {
        "description": "entries",
        "type": "object",
        "properties": {
          "op": {
            "type": "string",
            "enum": [
              "CREATE",
              "MODIFY",
              "DELETE"
            ],
            "description": "The type of change in the region of the file in the newer snapshot. The region may have been created, modified, or deleted compared to the older snapshot.:\n * `CREATE` - SNAPSHOT_FILE_DIFF_OPERATION_CREATE,\n * `DELETE` - SNAPSHOT_FILE_DIFF_OPERATION_DELETE,\n * `MODIFY` - SNAPSHOT_FILE_DIFF_OPERATION_MODIFY"
          },
          "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"
          }
        }
      }
    }
  }
}