POST Method

The POST HTTP method is most often used to create a new resource: for example, a new logon session. However, in Veeam Backup Enterprise Manager RESTful API the POST HTTP method can be used for other activities, for example:

Starting a job

Cloning a job

Downloading a file

Restoring a VM

Some POST HTTP requests do not require a request body: they are simply sent to the URL of a resource. For example, if you want to start a job, you should send a request of the following type:

POST http://localhost:9399/api/jobs/{ID}?action=start

Other POST HTTP requests require the request body. For example, if you want to clone a job in Veeam Backup Enterprise Manager, you need to send the HTTP POST request and communicate to the server the parameters for the cloned job in the request body. The body of the request must conform to the XML Schema of Veeam Backup Enterprise Manager RESTful API:

In case of success, the server returns the HTTP response code 202Accepted. The operation itself is performed in the asynchronous manner. The server creates a task for the operation completion and returns a link to this task to the client. Using this link, the client can monitor the task completion.