- About Veeam Backup for Nutanix AHV REST API
- Overview
- Changelog
- Authorization
- Backup Appliance Settings
- Backup Server
- Prism Centrals
- Clusters
- getGet Collection of Clusters
- getGet Cluster Data
- getGet Collection of Virtual Machines
- postInfrastructure Rescan for Virtual Machines
- getGet Virtual Machine Data
- getGet Collection of Protection Domains
- postInfrastructure Rescan for Protection Domains
- getGet Collection of Networks
- getGet Collection of Storage Containers
- getGet Collection of Cluster Hosts
- getGet Collection of Volume Groups in Cluster
- getGet Volume Group Data
- postInfrastructure Rescan for Volume Groups
- postCluster Rescan for Snapshots
- Dashboard
- getGet Resource Usage Statistics
- getGet Session Status Statistics for Last 24 Hours
- getGet Job Type Statistics
- getGet Number of Protected VMs
- getGet Collection of Unprotected VMs
- getGet Collection of Protected VMs
- getGet Collection of Recent Job Sessions Duration
- getGet Collection of Available Backup Repositories
- Jobs
- Monitoring
- Protected VMs
- Restore Points
- getGet VM Restore Points
- getGet Restore Point Data
- delDelete Restore Point
- getGet Protection Domain Snapshot Data
- getGet Backup Snapshot Data
- getGet User Snapshot Data
- getGet Backup Data
- postPerform VM Restore
- postPerform Disk Restore
- getGet Collection of Disks From Restore Point
- getGet Collection of Network Adapters From Restore Point
- Sessions
- SMTP Account
- Time Zones
- User Accounts
- Workers
- Virtual Machines
Get Collection of Jobs
The HTTP GET request to the /jobs
endpoint retrieves a list of all jobs created in Veeam Backup for Nutanix AHV.
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 Parameters. |
OK
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 200
- 400
- 401
- 403
- 500
{- "offset": 0,
- "limit": 0,
- "totalCount": 0,
- "results": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "settings": {
- "id": "string",
- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
- "compression": "None",
- "backupBlockSize": "None",
- "includes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "excludes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "diskFilterSettings": {
- "filters": [
- {
- "object": {
- "id": null,
- "clusterId": null,
- "type": null
}, - "filter": {
- "mode": null,
- "disks": [ ],
- "volumeGroups": [ ]
}
}
]
}, - "scheduleSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}, - "periodic": {
- "interval": 1,
- "mode": "Unknown"
}, - "automaticRetry": true,
- "retryCount": 0,
- "retryTimeDelay": 0
}, - "activeFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "deletedVmRetention": {
- "enabled": true,
- "days": 0
}, - "gfsSettings": {
- "enabled": true,
- "weekly": {
- "enabled": true,
- "weeklyRetention": 0,
- "day": "Unknown"
}, - "monthly": {
- "enabled": true,
- "monthlyRetention": 0,
- "week": "None"
}, - "yearly": {
- "enabled": true,
- "yearlyRetention": 0,
- "month": "Unknown"
}
}, - "healthCheckSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "syntheticFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "retentionSettings": {
- "type": "Unknown",
- "restorePointsToKeep": 0,
- "daysToKeep": 0
}
}, - "status": "Unknown",
- "objects": 0,
- "nextRunInfo": "string",
- "nextRunUtc": "2019-08-24T14:15:22Z",
- "lastRunUtc": "2019-08-24T14:15:22Z",
- "lastSessionId": "ef12b7ec-84a8-49ff-be5f-636424aa5ac4",
- "enabled": true
}
]
}
Create Job
The HTTP POST request to the /jobs
endpoint creates a new job.
Request Body schema: application/jsonrequired
Job object.
name required | string Name of the job. |
mode required | string (JobMode) Type of the job. |
required | object (RetentionSettings) |
required | object (ScheduleSettings) |
description | string or null Description of the job. |
repositoryId | string or null <uuid> ID of a repository where backups created by the job are stored. |
compression | string (JobCompressionType) Default: "Lz4" Backup compression level. |
backupBlockSize | string (BackupBlockSize) Backup block size. |
object or null (JobIncludes) | |
object or null (JobExcludes) | |
object or null (DiskFilterSettings) | |
object or null (ActiveFullSettings) | |
object or null (DeletedVmRetentionSettings) | |
object or null (GfsSettings) | |
object or null (HealthCheckSettings) | |
object or null (SyntheticFullSettings) |
Created
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- Payload
- curl
- Python
- JavaScript
- C#
- Go
{- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
- "compression": "None",
- "backupBlockSize": "None",
- "includes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "excludes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "diskFilterSettings": {
- "filters": [
- {
- "object": {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}, - "filter": {
- "mode": "Unknown",
- "disks": [
- {
- "busType": "Unknown",
- "index": 0
}
], - "volumeGroups": [
- {
- "id": "string",
- "name": "string"
}
]
}
}
]
}, - "scheduleSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}, - "periodic": {
- "interval": 1,
- "mode": "Unknown"
}, - "automaticRetry": true,
- "retryCount": 0,
- "retryTimeDelay": 0
}, - "activeFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "deletedVmRetention": {
- "enabled": true,
- "days": 0
}, - "gfsSettings": {
- "enabled": true,
- "weekly": {
- "enabled": true,
- "weeklyRetention": 0,
- "day": "Unknown"
}, - "monthly": {
- "enabled": true,
- "monthlyRetention": 0,
- "week": "None"
}, - "yearly": {
- "enabled": true,
- "yearlyRetention": 0,
- "month": "Unknown"
}
}, - "healthCheckSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "syntheticFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "retentionSettings": {
- "type": "Unknown",
- "restorePointsToKeep": 0,
- "daysToKeep": 0
}
}
- 201
- 400
- 401
- 403
- 500
{- "id": "string"
}
Get Job Data
The HTTP GET request to the /jobs/{id}
endpoint retrieves configuration of a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
OK
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 200
- 400
- 401
- 403
- 404
- 500
{- "id": "string",
- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "settings": {
- "id": "string",
- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
- "compression": "None",
- "backupBlockSize": "None",
- "includes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "excludes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "diskFilterSettings": {
- "filters": [
- {
- "object": {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}, - "filter": {
- "mode": "Unknown",
- "disks": [
- {
- "busType": null,
- "index": null
}
], - "volumeGroups": [
- {
- "id": null,
- "name": null
}
]
}
}
]
}, - "scheduleSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}, - "periodic": {
- "interval": 1,
- "mode": "Unknown"
}, - "automaticRetry": true,
- "retryCount": 0,
- "retryTimeDelay": 0
}, - "activeFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "deletedVmRetention": {
- "enabled": true,
- "days": 0
}, - "gfsSettings": {
- "enabled": true,
- "weekly": {
- "enabled": true,
- "weeklyRetention": 0,
- "day": "Unknown"
}, - "monthly": {
- "enabled": true,
- "monthlyRetention": 0,
- "week": "None"
}, - "yearly": {
- "enabled": true,
- "yearlyRetention": 0,
- "month": "Unknown"
}
}, - "healthCheckSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "syntheticFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "retentionSettings": {
- "type": "Unknown",
- "restorePointsToKeep": 0,
- "daysToKeep": 0
}
}, - "status": "Unknown",
- "objects": 0,
- "nextRunInfo": "string",
- "nextRunUtc": "2019-08-24T14:15:22Z",
- "lastRunUtc": "2019-08-24T14:15:22Z",
- "lastSessionId": "ef12b7ec-84a8-49ff-be5f-636424aa5ac4",
- "enabled": true
}
Delete Job
The HTTP DELETE request to the /jobs/{id}
endpoint deletes a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
No Content
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 400
- 401
- 403
- 404
- 500
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "extensions": {
- "property1": { },
- "property2": { }
}
}
Get Job Setting
The HTTP POST request to the /jobs/{id}/settings
endpoint retrieves settings of a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
OK
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 200
- 400
- 401
- 403
- 404
- 500
{- "id": "string",
- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
- "compression": "None",
- "backupBlockSize": "None",
- "includes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "excludes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "diskFilterSettings": {
- "filters": [
- {
- "object": {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}, - "filter": {
- "mode": "Unknown",
- "disks": [
- {
- "busType": "Unknown",
- "index": 0
}
], - "volumeGroups": [
- {
- "id": "string",
- "name": "string"
}
]
}
}
]
}, - "scheduleSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}, - "periodic": {
- "interval": 1,
- "mode": "Unknown"
}, - "automaticRetry": true,
- "retryCount": 0,
- "retryTimeDelay": 0
}, - "activeFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "deletedVmRetention": {
- "enabled": true,
- "days": 0
}, - "gfsSettings": {
- "enabled": true,
- "weekly": {
- "enabled": true,
- "weeklyRetention": 0,
- "day": "Unknown"
}, - "monthly": {
- "enabled": true,
- "monthlyRetention": 0,
- "week": "None"
}, - "yearly": {
- "enabled": true,
- "yearlyRetention": 0,
- "month": "Unknown"
}
}, - "healthCheckSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "syntheticFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "retentionSettings": {
- "type": "Unknown",
- "restorePointsToKeep": 0,
- "daysToKeep": 0
}
}
Modify Job Settings
The HTTP PUT request to the /jobs/{id}/settings
endpoint updates settings of a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
Request Body schema: application/jsonrequired
Specifies job settings.
name required | string Name of the job. |
mode required | string (JobMode) Type of the job. |
required | object (RetentionSettings) |
required | object (ScheduleSettings) |
description | string or null Description of the job. |
repositoryId | string or null <uuid> ID of a repository where backups created by the job are stored. |
compression | string (JobCompressionType) Default: "Lz4" Backup compression level. |
backupBlockSize | string (BackupBlockSize) Backup block size. |
object or null (JobIncludes) | |
object or null (JobExcludes) | |
object or null (DiskFilterSettings) | |
object or null (ActiveFullSettings) | |
object or null (DeletedVmRetentionSettings) | |
object or null (GfsSettings) | |
object or null (HealthCheckSettings) | |
object or null (SyntheticFullSettings) |
No Content
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Conflict. The request could not be processed.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- Payload
- curl
- Python
- JavaScript
- C#
- Go
{- "name": "string",
- "description": "string",
- "mode": "Unknown",
- "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
- "compression": "None",
- "backupBlockSize": "None",
- "includes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "excludes": {
- "objects": [
- {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}
]
}, - "diskFilterSettings": {
- "filters": [
- {
- "object": {
- "id": "string",
- "clusterId": "string",
- "type": "Unknown"
}, - "filter": {
- "mode": "Unknown",
- "disks": [
- {
- "busType": "Unknown",
- "index": 0
}
], - "volumeGroups": [
- {
- "id": "string",
- "name": "string"
}
]
}
}
]
}, - "scheduleSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}, - "periodic": {
- "interval": 1,
- "mode": "Unknown"
}, - "automaticRetry": true,
- "retryCount": 0,
- "retryTimeDelay": 0
}, - "activeFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "deletedVmRetention": {
- "enabled": true,
- "days": 0
}, - "gfsSettings": {
- "enabled": true,
- "weekly": {
- "enabled": true,
- "weeklyRetention": 0,
- "day": "Unknown"
}, - "monthly": {
- "enabled": true,
- "monthlyRetention": 0,
- "week": "None"
}, - "yearly": {
- "enabled": true,
- "yearlyRetention": 0,
- "month": "Unknown"
}
}, - "healthCheckSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "syntheticFullSettings": {
- "enabled": true,
- "type": "Unknown",
- "weekly": {
- "startTime": "10:00",
- "configuredDays": "None",
- "selectedDays": [
- "Unknown"
]
}, - "monthly": {
- "startTime": "10:00",
- "configuredWeekOrDay": "None",
- "dayOfWeek": "Unknown",
- "dayOfMonth": 0,
- "months": [
- "Unknown"
]
}
}, - "retentionSettings": {
- "type": "Unknown",
- "restorePointsToKeep": 0,
- "daysToKeep": 0
}
}
- 400
- 401
- 403
- 409
- 500
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "extensions": {
- "property1": { },
- "property2": { }
}
}
Start Job
The HTTP POST request to the /jobs/{id}/start
endpoint launches a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
query Parameters
backupMode | string (BackupMode) Specifies the backup type (active full or incremental). If the parameter value is not defined or is set to unknown, an incremental backup is created. If an incremental backup cannot be created or an active full backup is scheduled on this day, an active full backup will be created even if you start an incremental run. |
Accepted
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Conflict. The request could not be processed. Another backup or restore task is in progress.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 202
- 400
- 401
- 403
- 404
- 409
- 500
{- "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459"
}
Stop Job
The HTTP POST request to the /jobs/{id}/stop
endpoint stops execution of a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
No Content
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Conflict. The request could not be processed. Another backup or restore task is in progress.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 400
- 401
- 403
- 404
- 409
- 500
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "extensions": {
- "property1": { },
- "property2": { }
}
}
Retry Job
The HTTP POST request to the /jobs/{id}/retry
endpoint restarts the operation for the failed resources added to a job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
Accepted
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Conflict. The request could not be processed.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 202
- 400
- 401
- 403
- 404
- 409
- 500
{- "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459"
}
Enable Job
The HTTP POST request to the /jobs/{id}/enable
endpoint enables a disabled job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
No Content
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 400
- 401
- 403
- 404
- 500
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "extensions": {
- "property1": { },
- "property2": { }
}
}
Disable Job
The HTTP POST request to the /jobs/{id}/disable
endpoint disables an enabled job with the specified ID.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
No Content
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 400
- 401
- 403
- 404
- 500
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "extensions": {
- "property1": { },
- "property2": { }
}
}
Clone Job
The HTTP POST request to the /jobs/{id}/clone
endpoint creates a copy of a job with the specified ID. If the original job is scheduled to run automatically, the created job will be automatically disabled.
path Parameters
id required | string System ID assigned to a job in Veeam Backup for Nutanix AHV. |
Created
Bad Request. The request body is malformed, incomplete or otherwise invalid.
Unauthorized. The authorization header has been expected but not found (or found but is expired).
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request
Job Not Found. One or more resources specified in the request could not be found in the specified resource collection.
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.
- curl
- Python
- JavaScript
- C#
- Go
- 201
- 400
- 401
- 403
- 404
- 500
{- "id": "string"
}