Veeam Backup for AWS 10
REST API Reference
Related documents

Sla Templates

The /policyTemplates/slaTemplate resource collection represents SLA templates added to Veeam Backup for AWS configuration database.

Get Collection of SLA Templates

The HTTP GET request to the /policyTemplates/slaTemplate endpoint retrieves a list of SLA templates added to the Veeam Backup for AWS configuration database.

SecurityBearer
Request
query Parameters
SearchPattern
string

Returns only those items of a resource collection whose names match the specified search pattern in the parameter value.

Offset
integer <int32>

Specifies the first N items of a resource collection that will be excluded from the response.

Limit
integer <int32>

Specifies the maximum number of items of a resource collection that will be returned in the response.

header Parameters
x-api-version
required
string
Default: 1.8-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

Success

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.

500

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

503

Service Unavailable

504

Gateway Timeout

get/api/v1/policyTemplates/slaTemplates
Request samples 
Response samples 
application/json
{
  • "totalCount": 0,
  • "results": [
    ]
}
Create SLA Template
The HTTP POST request to the /policyTemplates/slaTemplate endpoint creates a new SLA template and adds the template to the Veeam Backup for AWS configuration database.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.8-rev0
Specifies the current version and revision of the Veeam Backup for AWS REST API.


 
Request Body schema: application/json
required
name
required
string
Specifies a name for the SLA template.


 
required
object (SlaConfiguration) 
 
description
string
Specifies a description of the SLA template.


 
Responses 
200
Success


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.


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


503
Service Unavailable


504
Gateway Timeout


post/api/v1/policyTemplates/slaTemplates
Request samples 
application/json
{
  • "name": "string",
  • "description": "string",
  • "slaConfiguration": {
    }
}
Response samples 
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "lastModifiedUtc": "2019-08-24T14:15:22Z",
  • "assignedPolicies": 0,
  • "slaConfiguration": {
    }
}
Get SLA Template Data
The HTTP GET request to the /policyTemplates/slaTemplate/{templateId} endpoint retrieves information on an SLA template with the specified ID.


SecurityBearer 
Request 
path Parameters
templateId
required
string <uuid> 
Specifies a system ID assigned to the SLA template in the Veeam Backup for AWS REST API.


 
header Parameters
x-api-version
required
string
 Default:  1.8-rev0
Specifies the current version and revision of the Veeam Backup for AWS REST API.


 
Responses 
200
Success


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.


503
Service Unavailable


504
Gateway Timeout


get/api/v1/policyTemplates/slaTemplates/{templateId}
Request samples 
Response samples 
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "lastModifiedUtc": "2019-08-24T14:15:22Z",
  • "assignedPolicies": 0,
  • "slaConfiguration": {
    }
}
Modify SLA Template
The HTTP PUT request to the /policyTemplates/slaTemplate/{templateId} endpoint updates settings of an SLA template with the specified ID.


SecurityBearer 
Request 
path Parameters
templateId
required
string <uuid> 
Specifies a system ID assigned to the SLA template in the Veeam Backup for AWS REST API..


 
header Parameters
x-api-version
required
string
 Default:  1.8-rev0
Specifies the current version and revision of the Veeam Backup for AWS REST API.


 
Request Body schema: application/json
required
name
required
string
Specifies a name for the SLA template.


 
required
object (SlaConfiguration) 
 
description
string
Specifies a description of the SLA template.


 
Responses 
200
Success


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.


503
Service Unavailable


504
Gateway Timeout


put/api/v1/policyTemplates/slaTemplates/{templateId}
Request samples 
application/json
{
  • "name": "string",
  • "description": "string",
  • "slaConfiguration": {
    }
}
Response samples 
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "lastModifiedUtc": "2019-08-24T14:15:22Z",
  • "assignedPolicies": 0,
  • "slaConfiguration": {
    }
}
Remove SLA Template
The HTTP DELETE request to the /policyTemplates/slaTemplate/{templateId} endpoint remove a specific SLA template from the Veeam Backup for AWS configuration database.


SecurityBearer 
Request 
path Parameters
templateId
required
string <uuid> 
Specifies a system ID assigned to the SLA template in the Veeam Backup for AWS REST API.


 
header Parameters
x-api-version
required
string
 Default:  1.8-rev0
Specifies the current version and revision of the Veeam Backup for AWS REST API.


 
Responses 
204
Deleted


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.


503
Service Unavailable


504
Gateway Timeout


delete/api/v1/policyTemplates/slaTemplates/{templateId}
Request samples 
Response samples 
application/json
{
  • "type": "http://example.com",
  • "title": "string",
  • "status": 400,
  • "errorCode": "AccessDenied",
  • "details": "string",
  • "instance": "http://example.com",
  • "data": {
    }
}
Get Policies That Have SLA Template Assigned
The HTTP GET request to the /policyTemplates/slaTemplate/{templateId}/assignedProtectionPolicies endpoint retrieves a list of SLA-based backup policies that have the specified SLA template assigned.


SecurityBearer 
Request 
path Parameters
templateId
required
string <uuid> 
Specifies a system ID assigned to the SLA template in the Veeam Backup for AWS REST API.


 
header Parameters
x-api-version
required
string
 Default:  1.8-rev0
Specifies the current version and revision of the Veeam Backup for AWS REST API.


 
Responses 
200
Success


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.


503
Service Unavailable


504
Gateway Timeout


get/api/v1/policyTemplates/slaTemplates/{templateId}/assignedPolicies
Request samples 
Response samples 
application/json
{
  • "totalCount": 0,
  • "results": [
    ]
}