B&R api - what is a task? what is a protected computer?

[CaptainAmazing]

Hey all,

I’m working through some REST API testing during our Veeam trial and running into a couple issues I could use help with:

Issue 1: /api/v1/agents/protectedComputers
I’ve got two Windows VMs:

Agents installed via VBR
Added to a protection group using “Individual computers”
Included in active backup jobs
Each has 5 restore points
Despite that, the endpoint returns an empty list. I’m trying to understand what conditions need to be met for a machine to show up here — seems like everything should be in place.

Issue 2: /api/v1/tasks
I’ve triggered a few things via the GUI:

Rescan of a protection group
Manual backup job execution
Both show up in the GUI with progress and success, but /tasks returns nothing. I’m using x-api-version: 1.1-rev1 and querying immediately after the action. Still getting:


Environment
Trial license
Auth via /api/session with bearer token
Actions triggered via GUI, not API

Questions
What exactly qualifies a machine as “protected” in the API?
What is the definition of a task?
Appreciate any insight — just trying to get a clean integration going.

[david.domask]

Hi CaptainAmazing,

1. https://helpcenter.veeam.com/docs/backu ... dComputers

Check the Type filter, Linux currently is supported as a type returned. These endpoints are being deprecated in v13 and will have new endpoints with better handling for Agent Management

2. https://helpcenter.veeam.com/docs/backu ... dComputers

The HTTP GET request to the /api/v1/tasks path allows you to get an array of restore tasks performed on the backup server.

[CaptainAmazing]

Thanks David,

Protected computers endpoint:
I've attempted that for protected computers. I've used the Linux option I still get back a 0 protected computers response from the API and the type filter is not required. Also the VMs I have on the proxmox server are windows machines so I don't think I would want that? I also have a standalone esxi up with a backed-up windows box on it and still nothing under protected computers.

The task endpoint
tasks shows nothing. I've restored a VM from the stand alone esxi, and there are 0 tasks returned.