Adding Object Storage Repository

With Veeam Backup & Replication REST API, you can add the following types of object storage repositories:

  • Microsoft Azure Blob storage, Microsoft Azure Archive storage, and Microsoft Azure Data Box storage
  • Amazon S3 storage, Amazon S3 Glacier storage, and AWS Snowball Edge storage
  • Google Cloud storage
  • S3 compatible storage
  • IBM Cloud storage
  • Wasabi Cloud storage

To add an object storage repository, take the following steps:

  1. Add a cloud credentials record required for connection to the object storage repository. For details, see Add Cloud Credentials Record.

In response, you receive a model of the created cloud credentials record with its ID. Save the ID, you will require it later.

  1. Choose a location (cloud container and folder) that you want to map to new object storage repository. Save folder names and container names.
  • To create a new folder, send the New Folder request. Note Veeam Backup & Replication REST API does not create new containers, you can create a folder inside an existing container only.
  1. Add a new object storage repository with the Add Repository requests.

In the request body among other parameters, specify the following parameters obtained in the previous steps:

  • Cloud credentials required for connection to the object storage repository
  • Cloud location you want to map to the object storage repository

Example

In this example, you will add a Microsoft Azure Blob storage. You have a backup server backupserver01. You need to add an Azure storage account that has access to the Azure cloud service, create the Repository01 folder, and map the new repository to the folder.

To add a Microsoft Azure object storage repository, take the following steps:

  1. Add a Microsoft Azure storage account required for connection to the object storage repository.

Adding Object Storage RepositoryRequest Example

In response, you receive a model of the created Azure storage account with its ID. Save the ID, you will require it later.

Adding Object Storage RepositoryResponse Example

  1. Choose a location (cloud containers and folders) that you want to map to the new Azure Blob object storage repository. Record folder names and container names.
  • To browse existing folders, send the POST HTTP request to the /cloudBrowser path. For details, see Get Cloud Hierarchy.

Adding Object Storage RepositoryRequest Example

In response, you receive a collection of cloud containers and their folders.

Adding Object Storage RepositoryResponse Example

  • To create a new folder, send the POST HTTP request to the /cloudBrowser/newFolder path. Note Veeam Backup & Replication REST API does not create new containers, you can create a folder inside an existing container only. For details, see New Folder.

Adding Object Storage RepositoryRequest Example

In response, you receive the 201 code and an empty response body.

Adding Object Storage RepositoryResponse Example

  1. To add a new Azure Blob storage repository, send the POST HTTP request to the backupInfrastructure/repositories path. For details, see Add Repository.

In the request body among other parameters, specify the following parameters obtained in the previous steps:

  • ID of the created Azure storage account
  • Location (names of the container and the new folder) you want to map to the object storage repository

Adding Object Storage RepositoryRequest Example

In response, you receive an infrastructure session. Within the session, the object storage repository is added to your backup infrastructure. To check the progress, track the session state.

Adding Object Storage RepositoryResponse Example

Page updated 12/2/2024

Page content applies to build 12.3.1.1139