Backup Server

The /backupServer resource collection represents the backup server settings and all backup repositories to which the backup appliance has access.

Get Backup Server Data

The HTTP GET request to the /backupServer endpoint retrieves information on the Veeam Backup & Replication server that manages the backup appliance.

SecurityBearer
Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request

404

No Backup Server Found

500

Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v7/backupServer
Request samples
Response samples
application/json
{
  • "address": "string",
  • "port": 65535,
  • "repositoriesCount": 0,
  • "state": "Unknown",
  • "version": "string"
}

Get Collection of Backup Repositories

The HTTP GET request to the /repositories endpoint retrieves a list of backup repositories to which the backup appliance has access.

SecurityBearer
Request
query Parameters
offset
integer <int32> >= 0
Default: 0

Excludes from a response the first N items of a resource collection.

limit
integer <int32> >= -1
Default: 100

Specifies the maximum number of items of a resource collection to return in a response.

write-only
Array of objects or null (FilterParameter)

Specifies the criteria for items to be returned in a response. For more information, see the Veeam Backup for Nutanix AHV REST API Reference Overview, section Filter Parameters.

write-only
Array of objects or null (SortParameter)

Specifies the order of items in the response. For more information, see the Veeam Backup for Nutanix AHV REST API Reference Overview, section Sort Parameter.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v7/backupServer/repositories
Request samples
Response samples
application/json
{
  • "offset": 0,
  • "limit": 0,
  • "totalCount": 0,
  • "results": [
    ]
}

Get Backup Repository Data

The HTTP GET request to the /repositories/{id} endpoint retrieves information on a backup repository with the specified ID.

SecurityBearer
Request
path Parameters
id
required
string <uuid>

Specifies the ID assigned to a backup repository in Veeam Backup for Nutanix AHV.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request

404

No Backup Server Found

500

Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v7/backupServer/repositories/{id}
Request samples
Response samples
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "totalSpace": 0,
  • "freeSpace": 0,
  • "usedSpace": 0
}

Rescan Nutanix AHV Backups

The HTTP POST request to the /backupServer/rescanBackups endpoint allows you to scan Veeam Backup & Replication repositories and to update information on available Nutanix AHV backups in the backup appliance configuration database.

SecurityBearer
Responses
202

Accepted

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request

404

No Backup Server Found

409

Conflict. The request could not be processed. Another task is in progress.

500

Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.

post/api/v7/backupServer/rescanBackups
Request samples
Response samples
application/json
{
  • "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459"
}

Document updated 9/03/2025

Page content applies to build 12.7.1.12