Sign in

v1

latestSwagger 2.02026-07-17176789777.3 KB
data

Query changed regions metadata.

This API provides for querying the metadata about the regions that are different between two snapshots of a disk in the AOS file system. (The snapshot specified by the reference parameter will be used as the basis for computing the changed regions.) The main use of this API is to enable incremental and differential backups. Since each region specifies whether the region is all zeros, reads of such zeroed regions need not have to be performed while backing up the underlying disk. When no reference is specified, the response includes all the allocated regions in the given disk.

post/data/changed_regions

Request body

end_offsetinteger

The absolute offset in bytes up to which to query for the changed regions. Note that the interval specified by the start_offset together with the end_offset is right half-open. If the end_offset is not specified, the portion from the start_offset till the end of the file will be included in the query.

snapshot_file_pathstring required

Absolute path of a file within a snapshot of an entity such as a virtual machine, a volume group or a protection domain.

start_offsetinteger

The absolute offset in bytes from where to query for the changed regions.

reference_snapshot_file_pathstring

Absolute path of a file within a snapshot that must be used as the reference in the computation of the changed regions. If this path is not specified, then the changed regions will not be computed. Instead, the sparse and the non-sparse regions of the file specified in snapshot_file_path will be returned.

Response

Success

next_offsetinteger

The offset from where the client must continue the request. This field will not be set when there are no more changed regions to be returned. Note that the next_offset can be outside the endOffset specified by the client in the request. This helps clients reach the next changed offset faster.

file_sizeinteger

Size of the file specified by snapshot_file_path.