Working with Veeam Smart Object Storage API (SOSAPI)

Veeam Backup & Replication offers Veeam Smart Object Storage application programming interface (SOSAPI) functionality to interact with S3 compatible object storage repositories. Object storage vendors can leverage SOSAPI to decrease impact on the production environment, significantly improve recovery point objective (RPO) and optimize the interaction between object storage and Veeam Backup & Replication. SOSAPI relies on Amazon S3 API protocol, uses its authorization mechanisms and existing S3 API calls. This approach does not require to set up a complex network infrastructure - there is no need to create additional ports, firewall rules or install any plug-ins. Instead, vendors need to handle the API requests to interact with S3 compatible object storage repositories.

Among others, SOSAPI functionality suggests taking advantage of the following options:

  • Capacity reports

Veeam Backup & Replication sends a warning if space capacity of an object storage repository reaches its limits. Also, you can check the amount of free space available in the object storage repository using Veeam Backup & Replication UI. For more information, see Editing Settings of Backup Repositories.

  • Enhanced scale-out backup repository placement policy

In case you use multiple extents within the scale-out backup repository, Veeam Backup & Replication will select the best extent to keep the evenly.

  • Load balancing on smart entity level

A vendor can implement internal load balancing for SOSAPI-enabled repositories.

This option allows to define that Veeam Backup & Replication will be able to perform read and write task with the necessary repositories using a set of vendor-defined IP addresses instead of only one endpoint address.


Load balancing is not supported for one type of tier (performance tier or capacity tier) if a scale-out backup repository contains more than one SOSAPI-enabled object storage repository within this tier.

Working with SOSAPI

To start working with SOSAPI, vendors must add to their object storage infrastructure a set of XML configuration files. Veeam Backup & Replication will automatically enable SOSAPI functionality supported by the vendor and provide corresponding capabilities to customers. After you add the S3 compatible object storage repositories with SOSAPI functionality to the backup infrastructure, it will show up as the S3-integrated type in working area.