Veeam Backup & Replication 13
REST API Reference
Related documents

General Options

The General Options section defines operations for retrieving and editing general settings of Veeam Backup & Replication.

Get General OptionsDeprecated

The HTTP GET request to the /api/v1/generalOptions endpoint gets Veeam Backup & Replication settings.

Available to: Backup Administrator.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.3-rev2

Version and revision of the client REST API. Must be in the following format: <version>-<revision>.

Responses
200

OK

401

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

403

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

404

Not found. No object was found with the path parameter specified in the request.

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/v1/generalOptions
Request samples 
Response samples 
application/json
{
  • "notificationEnabled": false,
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}
Edit General OptionsDeprecated
The HTTP PUT request to the /api/v1/generalOptions endpoint edits Veeam Backup & Replication settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
notificationEnabled
required
boolean
 Default:  false
If true, email notifications are enabled. In this case, the emailSettings property is required.


 
required
object (GeneralOptionsNotificationsModel) 
Other notifications such as notifications on low disk space, support contract expiration, and available updates.


 
required
object (GeneralOptionsSiemIntegrationModel) 
SIEM integration settings.


 
object (GeneralOptionsEmailNotificationsModel) 
Global email notification settings and job notifications.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions
Request samples 
application/json
{
  • "notificationEnabled": false,
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}
Response samples 
application/json
{
  • "notificationEnabled": false,
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}
Get Email Settings
The HTTP GET request to the /api/v1/generalOptions/emailSettings endpoint gets Veeam Backup & Replication email settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/emailSettings
Request samples 
Response samples 
application/json
{
  • "notificationsEnabled": true,
  • "mailServer": "SMTP",
  • "emailSettings": {
    },
  • "smtpServerName": "smtp.tech.local",
  • "advancedSmtpOptions": {
    }
}
Edit Email Settings
The HTTP PUT request to the /api/v1/generalOptions/emailSettings endpoint edits Veeam Backup & Replication email settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
notificationsEnabled
required
boolean
 Default:  false
If true, email notifications are enabled and the emailSettings property is required.


 
mailServer
string (EEmailSettingsServerType) 
Type of mail server.


 
object (GeneralOptionsEmailSettingsModel) 
Email notification settings.


 
smtpServerName
string
Full DNS name or IP address of the SMTP server.


 
object (AdvancedSmtpOptionsModel) 
Advanced global email notification settings.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/emailSettings
Request samples 
application/json
{
  • "notificationsEnabled": true,
  • "mailServer": "SMTP",
  • "emailSettings": {
    },
  • "smtpServerName": "smtp.tech.local",
  • "advancedSmtpOptions": {
    }
}
Response samples 
application/json
{
  • "notificationsEnabled": true,
  • "mailServer": "SMTP",
  • "emailSettings": {
    },
  • "smtpServerName": "smtp.tech.local",
  • "advancedSmtpOptions": {
    }
}
Send Test Email
The HTTP POST request to the /api/v1/generalOptions/emailSettings/testMessage endpoint sends a test email notification using the configured settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
204
Test email notification has been sent.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/emailSettings/testMessage
Request samples 
Response samples 
application/json
{
  • "errorCode": "UnexpectedContent",
  • "message": "One or more request parameters are not valid."
}
Check SMTP Server Certificate
The HTTP POST request to the /api/v1/generalOptions/emailSettings/checkSmtpConnection endpoint checks the SMTP server certificate. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
smtpServerName
required
string
Full DNS name or IP address of the SMTP server.


 
required
object (AdvancedSmtpOptionsModel) 
Advanced global email notification settings.


 
Responses 
200
OK


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/emailSettings/checkSmtpConnection
Request samples 
application/json
{
  • "smtpServerName": "smtp.tech.local",
  • "advancedSmtpOptions": {
    }
}
Response samples 
application/json
{
  • "isValid": true,
  • "thumbprints": [
    ]
}
Get Host Authentication Settings
The HTTP GET request to the /api/v1/generalOptions/hostAuthentication endpoint gets Veeam Backup & Replication host authentication settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/hostAuthentication
Request samples 
Response samples 
application/json
{
  • "mode": "TrustSpecified",
  • "trustedHostCount": 12
}
Edit Host Authentication Settings
The HTTP PUT request to the /api/v1/generalOptions/hostAuthentication endpoint edits Veeam Backup & Replication host authentication settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
mode
required
string (EHostTrustMode) 
Host trust mode.


 Enum: "TrustAll" "TrustSpecified"  
trustedHostCount
integer <int32> 
Number of trusted hosts in the environment. This property is read-only.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/hostAuthentication
Request samples 
application/json
{
  • "mode": "TrustSpecified",
  • "trustedHostCount": 12
}
Response samples 
application/json
{
  • "mode": "TrustSpecified",
  • "trustedHostCount": 12
}
Export Trusted Hosts List to a File
The HTTP POST request to the /api/v1/generalOptions/hostAuthentication/exportTrustedHosts endpoint exports trusted hosts to a file using the configured settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
path
required
string
Path to the file to which the list of trusted hosts is exported.


 
Responses 
204
Trusted hosts list has been exported to the requested file.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/hostAuthentication/exportTrustedHosts
Request samples 
application/json
{
  • "path": "C:\\Veeam\\Export\\trustedHosts.xml"
}
Response samples 
application/json
{ }
Import Trusted Hosts List from a File
The HTTP POST request to the /api/v1/generalOptions/hostAuthentication/importTrustedHosts endpoint imports trusted hosts from a file using the configured settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
path
required
string
Path to the file from which the list of trusted hosts is imported.


 
overwriteExistingTrustedHosts
required
boolean
If true, existing trusted hosts are overwritten during the import.


 
Responses 
200
Trusted hosts list has been imported from the requested file.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/hostAuthentication/importTrustedHosts
Request samples 
application/json
{
  • "path": "C:\\Veeam\\Export\\trustedHosts.xml",
  • "overwriteExistingTrustedHosts": true
}
Response samples 
application/json
{
  • "result": "Success",
  • "warnings": [
    ]
}
Get Notification Settings
The HTTP GET request to the /api/v1/generalOptions/notifications endpoint gets Veeam Backup & Replication notifications settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/notifications
Request samples 
Response samples 
application/json
{
  • "storageSpaceThresholdEnabled": true,
  • "storageSpaceThreshold": 10,
  • "datastoreSpaceThresholdEnabled": true,
  • "datastoreSpaceThreshold": 10,
  • "skipVMSpaceThresholdEnabled": true,
  • "skipVMSpaceThreshold": 5,
  • "notifyOnSupportExpiration": true,
  • "notifyOnUpdates": true
}
Edit Notification Settings
The HTTP PUT request to the /api/v1/generalOptions/notifications endpoint edits Veeam Backup & Replication notification settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
storageSpaceThresholdEnabled
required
boolean
If true, notifications about critical amount of free space in backup storage are enabled.


 
datastoreSpaceThresholdEnabled
required
boolean
If true, notifications about critical amount of free space in a production datastore are enabled.


 
skipVMSpaceThresholdEnabled
required
boolean
If true and the skipVMSpaceThreshold threshold is reached, Veeam Backup & Replication terminates backup and replication jobs working with production datastores before VM snapshots are taken.


 
notifyOnSupportExpiration
required
boolean
If true, notifications about support contract expiration are enabled.


 
notifyOnUpdates
required
boolean
If true, notifications about updates are enabled.


 
storageSpaceThreshold
integer <int32>   [ 1 .. 100 ] 
Space threshold of backup storage, in percent.


 
datastoreSpaceThreshold
integer <int32>   [ 1 .. 100 ] 
Space threshold of a production datastore, in percent.


 
skipVMSpaceThreshold
integer <int32> 
Space threshold of a production datastore, in percent.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/notifications
Request samples 
application/json
{
  • "storageSpaceThresholdEnabled": true,
  • "storageSpaceThreshold": 10,
  • "datastoreSpaceThresholdEnabled": true,
  • "datastoreSpaceThreshold": 10,
  • "skipVMSpaceThresholdEnabled": true,
  • "skipVMSpaceThreshold": 5,
  • "notifyOnSupportExpiration": true,
  • "notifyOnUpdates": true
}
Response samples 
application/json
{
  • "storageSpaceThresholdEnabled": true,
  • "storageSpaceThreshold": 10,
  • "datastoreSpaceThresholdEnabled": true,
  • "datastoreSpaceThreshold": 10,
  • "skipVMSpaceThresholdEnabled": true,
  • "skipVMSpaceThreshold": 5,
  • "notifyOnSupportExpiration": true,
  • "notifyOnUpdates": true
}
Get Event Forwarding Settings
The HTTP GET request to the /api/v1/generalOptions/eventForwarding endpoint gets Veeam Backup & Replication event forwarding settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/eventForwarding
Request samples 
Response samples 
application/json
{
  • "SNMPServers": [
    ],
  • "syslogServer": {
    },
  • "syslogEventFiltering": [
    ]
}
Edit Event Forwarding Settings
The HTTP PUT request to the /api/v1/generalOptions/eventForwarding endpoint edits Veeam Backup & Replication event forwarding settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
Array of objects (GeneralOptionsSNMPServerModel) 
Array of SNMP servers.


 
object (GeneralOptionsSyslogServerModel) 
Syslog server settings.


 
Array of objects (GeneralOptionsSyslogEventFilteringModel) 
Array of syslog event filters.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/eventForwarding
Request samples 
application/json
{
  • "SNMPServers": [
    ],
  • "syslogServer": {
    },
  • "syslogEventFiltering": [
    ]
}
Response samples 
application/json
{
  • "SNMPServers": [
    ],
  • "syslogServer": {
    },
  • "syslogEventFiltering": [
    ]
}
Get Storage Latency Settings
The HTTP GET request to the /api/v1/generalOptions/storageLatency endpoint gets storage latency settings configured for backup and replication operations. Storage latency control allows you to limit Input/Output operations on the production storage where protected machines reside.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/storageLatency
Request samples 
Response samples 
application/json
{
  • "storageLatencyControlEnabled": true,
  • "storageLatencyControlOptions": {
    }
}
Edit Storage Latency Settings
The HTTP PUT request to the /api/v1/generalOptions/storageLatency endpoint edits storage latency settings configured for backup and replication operations. Storage latency control allows you to limit Input/Output operations on the production storage where protected machines reside.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
storageLatencyControlEnabled
required
boolean
 Default:  false
If true, storage latency control is enabled. In this case, you must specify the storageLatencyControlOptions property.


 
object (StorageLatencyControlOptions) 
Latency control options.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/storageLatency
Request samples 
application/json
{
  • "storageLatencyControlEnabled": true,
  • "storageLatencyControlOptions": {
    }
}
Response samples 
application/json
{
  • "storageLatencyControlEnabled": true,
  • "storageLatencyControlOptions": {
    }
}
Add Latency Settings for Specific Datastore
The HTTP POST request to the /api/v1/generalOptions/storageLatency/datastores endpoint adds custom latency settings for a specific datastore.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
required
object (InventoryObjectModel) 
Inventory object properties.


 
latencyLimitMs
integer
 Default:  20
I/O latency threshold (in milliseconds) at which Veeam Backup & Replication will stop assigning new tasks to the datastore or volume.


 
throttlingIOLimitMs
integer
 Default:  30
I/O latency limit (in milliseconds) at which Veeam Backup & Replication will slow down read and write operations for the datastore or volume.
latencyLimitMs must not be greater than throttlingIOLimitMs.


 
Responses 
201
Datastore latency settings record has been added.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


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/v1/generalOptions/storageLatency/datastores
Request samples 
application/json
{
  • "storageObject": {
    },
  • "latencyLimitMs": 20,
  • "throttlingIOLimitMs": 30
}
Response samples 
application/json
{
  • "id": "d1c2b3a4-5e6f-4708-9a1b-2c3d4e5f6071",
  • "storageObject": {
    },
  • "latencyLimitMs": 25,
  • "throttlingIOLimitMs": 40
}
Get Latency Settings for Specific Datastore
The HTTP GET request to the /api/v1/generalOptions/storageLatency/datastores/{id} endpoint gets custom latency settings configured for a specific datastore.
Available to: Backup Administrator.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
ID of a datastore latency settings record. To get the ID, run the  Get Storage Latency Settings request.


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/storageLatency/datastores/{id}
Request samples 
Response samples 
application/json
{
  • "id": "d1c2b3a4-5e6f-4708-9a1b-2c3d4e5f6071",
  • "storageObject": {
    },
  • "latencyLimitMs": 25,
  • "throttlingIOLimitMs": 40
}
Edit Latency Settings for Specific Datastore
The HTTP PUT request to the /api/v1/generalOptions/storageLatency/datastores/{id} endpoint edits custom latency settings configured for a specific datastore.
 Available to: Backup Administrator.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
ID of a datastore latency settings record. To get the ID, run the  Get Storage Latency Settings request.


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
id
required
string <uuid> 
ID of the datastore latency settings record.


 
required
object (InventoryObjectModel) 
Inventory object properties.


 
latencyLimitMs
integer
 Default:  20
I/O latency threshold (in milliseconds) at which Veeam Backup & Replication will stop assigning new tasks to the datastore or volume.


 
throttlingIOLimitMs
integer
 Default:  30
I/O latency speed limit (in milliseconds) at which Veeam Backup & Replication will slow down read and write operations for the datastore or volume.
latencyLimitMs must not be greater than throttlingIOLimitMs.


 
Responses 
200
Credentials record has been updated.


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/storageLatency/datastores/{id}
Request samples 
application/json
{
  • "id": "d1c2b3a4-5e6f-4708-9a1b-2c3d4e5f6071",
  • "storageObject": {
    },
  • "latencyLimitMs": 25,
  • "throttlingIOLimitMs": 40
}
Response samples 
application/json
{
  • "id": "d1c2b3a4-5e6f-4708-9a1b-2c3d4e5f6071",
  • "storageObject": {
    },
  • "latencyLimitMs": 25,
  • "throttlingIOLimitMs": 40
}
Remove Latency Settings for Specific Datastore
The HTTP DELETE request to the /api/v1/generalOptions/storageLatency/datastores/{id} endpoint removes custom latency settings configured for a specific datastore.
 Available to: Backup Administrator.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
ID of a datastore latency settings record. To get the ID, run the  Get Storage Latency Settings request.


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
204
Datastore latency settings record is deleted.


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


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


404
Not found. No object was found with the path parameter specified in the request.


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


delete/api/v1/generalOptions/storageLatency/datastores/{id}
Request samples 
Response samples 
application/json
{
  • "errorCode": "AccessDenied",
  • "message": "Unauthorized. Get bearer JWT token at /api/login"
}
Get VSA Event Forwarding Settings
The HTTP GET request to the /api/v1/generalOptions/vsaEventForwarding path allows you to get Infrastructure Metrics Syslog events forwarding settings. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/vsaEventForwarding
Request samples 
Response samples 
application/json
{
  • "enabled": true,
  • "useGeneralSyslogOptions": false,
  • "server": {
    },
  • "severity": [
    ],
  • "advancedFilters": [
    ]
}
Edit VSA Event Forwarding Settings
The HTTP PUT request to the /api/v1/generalOptions/vsaEventForwarding path allows you to update Infrastructure Metrics Syslog events forwarding settings.
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
enabled
required
boolean
If true, metrics forwarding is enabled.


 
severity
required
Array of strings (EVsaEventSeverity) 
Event levels to include by default.


Items Enum: "Emergency" "Alert" "Critical" "Error" "Warning" "Notice" "Informational" "Debug"  
required
Array of objects (VsaEventForwardingFilterModel) 
Application and logging level filters.


 
useGeneralSyslogOptions
boolean
If true, on save the persisted server settings (name, port, transport protocol) are overwritten with a snapshot of the backup server's general Syslog options; the inbound server field is ignored. Reads always return the persisted snapshot. Saving while this flag is true and the general Syslog options are disabled results in a 400 response.


 
object (VsaEventServerModel) 
Infrastructure metrics - VSA Syslog server settings.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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


put/api/v1/generalOptions/vsaEventForwarding
Request samples 
application/json
{
  • "enabled": true,
  • "useGeneralSyslogOptions": false,
  • "server": {
    },
  • "severity": [
    ],
  • "advancedFilters": [
    ]
}
Response samples 
application/json
{
  • "enabled": true,
  • "useGeneralSyslogOptions": false,
  • "server": {
    },
  • "severity": [
    ],
  • "advancedFilters": [
    ]
}
Get Daemon Settings for VSA Event Forwarding
The HTTP GET request to the /api/v1/generalOptions/vsaEventForwarding/daemonSettings path allows you to get Infrastructure Metrics Syslog daemon event forwarding configuration. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


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


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


404
Not found. No object was found with the path parameter specified in the request.


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/v1/generalOptions/vsaEventForwarding/daemonSettings
Request samples 
Response samples 
application/json
{
  • "configSpec": "$ModuleLoad imuxsock\n$RuleSet veeam\n*.* @@syslog.tech.local:6514"
}
Edit Daemon Settings for VSA Event Forwarding
The HTTP PUT request to the /api/v1/generalOptions/vsaEventForwarding/daemonSettings path allows you to update Infrastructure Metrics Syslog daemon event forwarding configuration. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
configSpec
required
string
Daemon filter configuration in XML format.


 
Responses 
204
No Content


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


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


put/api/v1/generalOptions/vsaEventForwarding/daemonSettings
Request samples 
application/json
{
  • "configSpec": "$ModuleLoad imuxsock\n$RuleSet veeam\n*.* @@syslog.tech.local:6514"
}
Response samples 
application/json
{
  • "errorCode": "UnexpectedContent",
  • "message": "One or more request parameters are not valid."
}
Get Node Exporter Settings
The HTTP GET request to the /api/v1/generalOptions/nodeExporterSettings path allows you to get the node exporter settings. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


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/v1/generalOptions/nodeExporterSettings
Request samples 
Response samples 
application/json
{
  • "metricsSharingEnabled": true,
  • "tlsEnabled": true,
  • "auth": {
    }
}
Update Node Exporter Settings
The HTTP PUT request to the /api/v1/generalOptions/nodeExporterSettings path allows you to update the node exporter settings. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
metricsSharingEnabled
required
boolean
If true, metrics sharing is enabled.


 
tlsEnabled
required
boolean
If true, the secured connection over TLS is enabled.


 
required
object (NodeExporterAuthenticationModel) 
Node Exporter authentication.


 
Responses 
200
Settings have been updated


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


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


put/api/v1/generalOptions/nodeExporterSettings
Request samples 
application/json
{
  • "metricsSharingEnabled": true,
  • "tlsEnabled": true,
  • "auth": {
    }
}
Response samples 
application/json
{
  • "metricsSharingEnabled": true,
  • "tlsEnabled": true,
  • "auth": {
    }
}
Set Node Exporter Basic Authentication
The HTTP POST request to the /api/v1/generalOptions/nodeExporterSettings/setBasicAuth path allows you to set a new user name and password for node exporter basic authentication. 
Available to: Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
username
required
string
User name for basic authentication.


 
password
required
string <password> 
Password for basic authentication.


 
type
required
string (ENodeExporterAuthType) 
Node Exporter authentication type.


 
Responses 
200
Settings have been updated


400
Bad request. This error is related to POST/PUT requests. 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 the request does not have adequate privileges to access one or more objects specified in the request.


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/v1/generalOptions/nodeExporterSettings/setBasicAuth
Request samples 
application/json
{
  • "type": "UsernamePassword",
  • "username": "TECH\\Administrator",
  • "password": "P@ssw0rd!2026"
}
Response samples 
application/json
{
  • "type": "UsernamePassword",
  • "username": "TECH\\Administrator",
  • "password": "P@ssw0rd!2026"
}