api: Add 'file_storage_volume' extension

Signed-off-by: Piotr Resztak <piotr.resztak@futurfusion.io>

client/interfaces.go

@@ -389,6 +389,7 @@ type InstanceServer interface {
 	CreateStoragePoolVolumeFromISO(pool string, args StorageVolumeBackupArgs) (op Operation, err error)
 	CreateStoragePoolVolumeFromMigration(pool string, volume api.StorageVolumesPost) (op Operation, err error)
 
+	// Storage volume file manipulations functions ("file_storage_volume" API extension)
 	GetStorageVolumeFile(pool string, volumeType string, volumeName string, filePath string) (content io.ReadCloser, resp *InstanceFileResponse, err error)
 	CreateStorageVolumeFile(pool string, volumeType string, volumeName string, filePath string, args InstanceFileArgs) (err error)
 	DeleteStorageVolumeFile(pool string, volumeType string, volumeName string, filePath string) (err error)

doc/api-extensions.md

@@ -2920,3 +2920,8 @@ A `used_by` field was added to the `GET /1.0/cluster/groups/{name}` endpoint.
 ## `bpf_token_delegation`
 
 This adds support for [eBPF token delegation](https://docs.ebpf.io/linux/concepts/token/).
+
+## `file_storage_volume`
+
+This adds file transfer API on the custom volumes.
+Implements `DELETE`, `GET`, `HEAD`, `POST` operations on the `/1.0/storage-pools/{poolName}/volumes/{type}/{volumeName}/files` endpoint.

internal/version/api.go

@@ -504,6 +504,7 @@ var APIExtensions = []string{
 	"instance_systemd_credentials",
 	"cluster_group_usedby",
 	"bpf_token_delegation",
+	"file_storage_volume",
 }
 
 // APIExtensionsCount returns the number of available API extensions.