Skip to main content

Storage file clone endpoint overview

Contributors

Overview

You can use these API's to create file clones, retrieve split status and manage split loads. These endpoints are used for cloning files within a volume, without taking much of extra space. Child and parent clones shares the unchanged blocks of data.

A file clone split operation detach child clone from its parent. Split operations use space. To ensure that file clone create operation is not affected by split, file clone tokens are use to reserve space. API endpoints can be used to update the validity and space reserved by token.

File clone APIs

The following APIs are used to perform the following operations:

– POST /api/storage/file/clone

– GET /api/storage/file/clone/split-status

– PATCH /api/storage/file/clone/split-loads/{node.uuid}

– GET /api/storage/file/clone/split-loads/{node.uuid}

– GET /api/storage/file/clone/split-loads

– GET /api/storage/file/clone/tokens/

– DELETE /api/storage/file/clone/tokens/{node.uuid}/{token.uuid}

– PATCH /api/storage/file/clone/tokens/{node.uuid}/{token.uuid}