Veeam Backup Enterprise Manager REST API is practically a hierarchy of resources. When the client accesses the REST API, it obtains a list of resources that the client can use. All resources can be divided into two groups:
- Key resources, or entities, are top-level objects. These are primary objects that the client can address: jobs, VMs, restore points and so on. Key resources are uniquely identified by entity IDs in the URN format. The client can get information about key resources and perform actions with them: modify resource properties, create and delete resources and so on.
- Other resources are auxiliary objects handled by the REST API, for example: tasks, file system entries, credentials and so on. Typically, these resources do not have any actions associated with them. The client can access such resources to get some information about them but cannot perform any operation with them.
Some resources are grouped in collections. A resource collection contains objects of the same type: for example, the BackupServers collection contains all backup servers connected to Veeam Backup Enterprise Manager. The resource collection itself is a resource: you can access it and get information about all objects contained in the collection.
The REST API operates with the following resource types: