Skip to main content

VDR

VDR is an interface for performing CRUD and verification operations on a generic data storage driver. The specification is available here, along with a reference implementation provided as a library. The interface defines simple create, read, update, delete, and verify operations, delegating their execution to an underlying driver. Driver is an actual implementation of a data storage mechanism.

HTTP binding

Although the VDR implementation is available as a library, it is also integrated intothe Cloud Agent to expose its functionality via HTTP, supporting use cases where direct library integration is not feasible.

The Cloud Agent exposes the VDR functionality through a RESTful stlye API, providing an interface analogous to direct method calls.

Example

OperationHTTP Endpoint
create(data, options)POST /vdr/entries?drid=...
read(url, options)GET /vdr/entries?url=...
update(url, data, options)PUT /vdr/entries?url=...
delete(url, options)DELETE /vdr/entries?url=...

Selecting VDR drivers

The driver is a key component of VDR, providing the actual implementation for the storage backend. The cloud agent acts as a proxy, supporting multiple drivers and allowing users to choose the one that best fits their needs. To select the appropriate driver, specify the following parameters when creating a VDR entry.

ParametersDescription
dridDriver ID
drfDriver famely
drvDriver version

Currently, the Cloud Agent supports the following drivers

DriverIDFamilyVersionDescription
In-memorymemorymemory0.1.0Driver storing data in-memory for testing
Databasedatabasedatabase0.1.0Driver storing data in local database testing purposes

For a full range of parameters and driver options, please refer the the VDR specification.