Throttling

To avoid excessive loading of Veeam Service Provider Console server caused by processing too many requests simultaneously or during a specific time period, the Veeam Service Provider Console REST API controls request rate through throttling mechanism.

Each request is classified as a part of one or more of the following groups:

  • All requests
  • Requests with specific UserId parameter value
  • Requests with specific IpAddress parameter value
  • Requests with specific UserID and IpAddress parameter values

According to throttling policy of those groups, a request is processed if it fits both of the following limitations:

  • Maximum number of requests processed simultaneously
  • Maximum number of requests processed during a unit of time

If at least one of those limitations is exceeded, server returns error with the 429 code. If maximum number of requests processed during a specific time period is exceeded, the response additionally may contain the retryAfter property that has the value equal to the number of seconds till the next time period begins:

{

"errors": [

 {

  "type": "transport",

  "code": 429,

  "retryAfter": 25

 }

]

}

For details on how to modify throttling limitations, see the Throttling Settings section.