Last modified October 31, 2024

Management Console API Documentation

Overview

Introduction

JetBackup Management Console API accesses the JetBackup MC interface's features.
You can use this API to perform all the tasks you perform from the JetBackup MC GUI and more!
With JetBackup MC API you can manage and optimize backup Jobs within all your Servers.

Authentication

In order to communicate with the JetBackup MC server, you will need to create an API Access Token through the Users section of the JetBackup MC or through Manage Access Token API Call.
After creating the API access token, you will need to pass it in the request header, for example:

curl -k -H "Authorization: Bearer testuser:9MKjw55we7TIq0CdpaHaiYHacB5hQOqp" "https://1.1.1.1:3031/API/manageServer/?_id=5b30da08d5ac5e06897b47e2&action=modify&name=JBServer1"

Basic usage

<?php
 $user = "USER";
 $token = "MYAPITOKEN";

 $query = "https://HOST_NAME:3031/API/";

 $params = [
    'function' => 'getServer',
     '_id' => SERVER_ID,
 ];

 $curl = curl_init();
 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0);
 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);
 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);

 $header = ["Authorization: Bearer $user:$token"];

 curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
 curl_setopt($curl, CURLOPT_URL, $query);
 curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params));

 $result = curl_exec($curl);

 $http_status = curl_getinfo($curl, CURLINFO_HTTP_CODE);

 if ($http_status != 200) {
     echo "[!] Error: " . $http_status . " returned\n";
 } else {
     $json = json_decode($result);
     print_r($json);
 }

 curl_close($curl);
?>
#! /bin/bash
user=USER
token=USERAPITOKEN
header='Authorization: Bearer '$user':'$token

query='https://HOST_NAME:3031/API/'

params='{"function":"getServer","_id":SERVER_ID}'

curl $query -H "$header" -d $params -k
jetapi backupmc -F listOptimizers

For more information about jetapi basic usage click on Jetapi Parameters

API Response

On each function page, you will find details for the response data.
All the API call returns this object:

{
   "success":1,
   "message":"Logged In Successfully",
   "system":
   {
      "version":"1.0.0",
      "licenseIssue":false
   }
   "data":{},
}

Parameters

Parameter Type Description Possible Values Example
success Boolean Whether the API call was successful
message String Success/failure message.
data Object The returned Data. You already have a download for this backup
system Object System information To view the possible values click on System Object