KEMP 360 Central API

1 Introduction

This document describes the KEMP 360 Central RESTful Application Program Interface (API). This interface is designed to allow remote applications access to the KEMP 360 Central product in a simple and consistent manner. The output is provided in JavaScript Object Notation (JSON) format.

1.1 Document Purpose

This document describes the API to the KEMP 360 Central product. It describes how to configure the various features of KEMP 360 Central using the API.

This document only contains a subset of the API commands.

This document does not explain each of the features or options in detail. For further information, please refer to the KEMP 360 Central, Feature Description document on www.kemptechnologies.com/loadmaster-documentation.

1.2 Intended Audience

This document is intended to help anyone who wishes to configure KEMP 360 Central using the API.

2 The KEMP 360 Central API

2.1 Notation

In the following examples, text which is italicized indicates a value that must be entered, for example:

/api/v1/loadmaster/LoadMasterID/?&api_key=APIKey&username=Username

In the example above; LoadMasterID, APIKey and UsernameValue all relate to values that should be entered, for example 9, de26b104526be42ec7e0454d363345a15be4c453 and admin respectively, for example:

/api/v1/loadmaster/9/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin

2.2 KEMP 360 Central API Overview

The KEMP 360 Central API enables a user or application to pass requests to the KEMP 360 Central product. KEMP 360 Central answers the request with a JSON response.

The KEMP 360 Central API commands can be run using cURL. Some GET requests can also be run by using a browser address bar.

Example syntax for a cURL command follows:

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/:ResourceName/?&api_key=APIKey&username=Username"

The KEMP 360 Central API commands are categorized by resource. The relevant resource name must be entered when running a KEMP 360 Central API command. The resources relate to the different areas that can be updated, for example:

To get a list of the resources run the following command:

curl -k "https://KEMP360CentralIPAddress/api/v1/"

2.2.1 Authentication

For security reasons, the api_key and the username must be included at the end of the command each time a command is run.

To generate the API key, run the authenticate command, for example:

curl -k -X POST -d '{"username":"Username","password":"Password"}' “https://KEMP360CentralIPAddress/api/v1/user/authenticate/”

The following is an example response:

{

    "apikey": "06dd33ffba437f858774c13419e982ae11a53c70",

    "success": true

}

The api_key is generated per user and per KEMP 360 Central machine and it will not change. So, you should only have to run the authenticate command once per KEMP 360 Central machine. The api_key that is generated can only be reused against the same KEMP 360 Central machine. If an incorrect api_key is entered, the user receives a 401 unauthorized error.

2.2.2 HTTP Methods

The HTTP methods of POST, GET, PUT and DELETE are used when running a command. They correspond to the Create, Read, Update and Delete (CRUD) operations, respectively.

You should note the following points regarding the formatting of the request:

  • Only one command can be given at a time
  • Multiple parameters can be set within the same command
  • The order in which the parameter/value pairs appear does not matter

2.2.3 Setting Parameters

Any parameters that must be specified can be passed in the payload, for example:

{

"username":"Username","password":"Password"

}

When there is more than one parameter in a request, individual parameters are separated using a comma (,).

To view the full list of valid parameters for a resource, run the schema command:

/api/v1/ResourceName/schema/?&api_key=APIKey&username=Username

For example, to view all parameters for the network resource:

curl -k -X GET "https://10.154.190.112/api/v1/network/schema/?username=admin&api_key=b4e336d84e6a0213e1b9d3c7e32152b7b51c6658"

2.2.4 Errors

If any issues occur when running the command, for example if any required parameters are missing, an error message appears.

The following is an example error message output:

HTTP/1.1 400 BAD REQUEST

Date: Fri, 14 Aug 2015 12:57:45 GMT

Server: Apache/2.4.7 (Ubuntu)

X-Frame-Options: SAMEORIGIN

Connection: close

Transfer-Encoding: chunked

Content-Type: application/json

{

    "error": "The 'network' field has no data and doesn't allow a default or null value."

}

2.3 KEMP 360 Central API Commands

Details of the available KEMP 360 Central API commands are provided in the following sections.

2.3.1 Manage KEMP 360 Central Commands

You can use the 360 resource to perform some administrative tasks in KEMP 360 Central.

2.3.1.1 License KEMP 360 Central

The following section outlines all the commands that are required to license KEMP 360 Central.

  1. Accept the Welcome Page.

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/config/1/" -H "Content-Type: application/json" -k -v -d "{\"deployment_date\":\"null\",\"id\":\"1\",\"isAdminPassSet\":\"false\",\"isEulaAccepted\":\"true\",\"isLicensed\":\"false\",\"is_fingerprint_generated\":\"false\",\"resource_uri\":\"/api/v1/config/1/\"}"

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Mon, 05 Mar 2018 09:46:27 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Content-Length: 0

Content-Type: text/html; charset=utf-8

*

2. Retrieve the API key. The API key is required in subsequent commands.

Example Command

curl -X POST "https://KEMP360CentralIPAddress/api/v1/user/authenticate/" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"admin\"}"

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:12:36 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"apikey": "1d2046ad8e89a301edca3ce1cc5152fae949a216", "id": 1, "success": true}*

3. Configure the proxy. This command should be run as is.

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/360/unset_proxy/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:15:01 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Cache-Control: no-cache

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "Proxy parameters unset"}

4. License KEMP 360 Central.

This command allows the user to license their KEMP 360 Central. In the MELA case, the Contract ID is provided by KEMP Operations and is a mandatory parameter.

Example Command

curl -X POST "https://KEMP360CentralIPAddress/api/v1/360/license/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k -v -d "{\"kempid\":\"KEMPIDEmailAddress\",\"password\":\"KEMPIDPassword\",\"order_id\":\"ContractID\"}"

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:21:45 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Content-Length: 54

Content-Type: application/json

{"message": "KEMP360 has been licensed successfully."}

5. Configure the admin username and password.

This is a two-step process, where initially the admin account is confirmed. Subsequently, the password is updated.

Example Command

curl -X POST "https://KEMP360CentralIPAddress/api/v1/user/authenticate/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"admin\"}"

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:24:29 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"apikey": "1d2046ad8e89a301edca3ce1cc5152fae949a216", "id": 1, "success": true}

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/user/1/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k -v -d "{\"password\":\"KEMP360CentralPassword\"}"

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:30:44 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"email": "", "groups": ["/api/v1/resourcegroup/2/", "/api/v1/resourcegroup/1/"], "id": 1, "is_active": true, "is_superuser": true, "permissions": ["SystemSettings.read", "SystemSettings.write", "Monitoring", "ServiceConfiguration.read", "ServiceConfiguration.write"], "pk": "1", "resource_uri": "/api/v1/user/1/", "username": "admin"}

6. Confirm all the settings. This command should be run as is.

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/config/1/" -H "Content-Type: application/json" -k -v -d "{\"isAdminPassSet\":\"true\",\"isEulaAccepted\":\"true\",\"isLicensed\":\"true\",\"is_fingerprint_generated\":\"true\"}"

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Mon, 05 Mar 2018 10:28:25 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Content-Length: 0

Content-Type: text/html; charset=utf-8

*

2.3.1.2 View the Details of a License

You can use a GET command to view the details of a KEMP 360 Central license.

/api/v1/360/license/details/

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/360/license/details/?&api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 11:10:51 GMT

Server: Apache

Cache-Control: no-cache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"access_code": "8DPtDB4QvD", "asl_enabled": true, "asl_instance_grace_period": 30, "asl_instance_sku": "", "blob_create": "", "blob_delete": "", "fingerprint": "QNY34-Etl76-jS7uB-Myny5-rfk9X-82Cww-awft3-e", "id": 1, "ignore_kts_hwid": true, "is_mela": true, "is_tethered": false, "kemp360_ip": "10.0.0.16", "kts_mela_grace_period": 90, "license_expiration": "Unlimited", "license_name": "K360-MELA-VLM-WAF", "license_status": "Single Perm", "max_loadmaster_activations": 500, "max_loadmasters": 500, "serial_number": "KTS1082322", "status": "In Use", "support_expiration": "2019-07-20T00:00:00", "support_name": "Premium"}

2.3.1.3 Reboot KEMP 360 Central  

You can use a GET method to reboot KEMP 360 Central.

/api/v1/360/reboot/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X GET "https://10.154.190.179/api/v1/360/reboot/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin"

Expected Output

{

    "message": "System rebooting."

}  

2.3.1.4 Shut Down KEMP 360 Central

You can use a GET method to shut down KEMP 360 Central.

This shuts down the KEMP 360 Central Virtual Machine. After shutting down, the Virtual Machine must be powered back on to turn the KEMP 360 Central instance back on.

/api/v1/360/shutdown/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X GET "https://10.154.190.179/api/v1/360/shutdown/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin"

Expected Output

{

    "message": "System shutting down."

}

2.3.1.5 Set the Email Options

To configure the email options for KEMP 360 Central, you can use a PUT method.

/api/v1/360/1/?api_key=APIKey&username=Username

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/360/1/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k -v -d "{\"email_host\":\"2.2.2.2\",\"email_port\":\"25\",\"email_address_list\":\"jbloggs@kemptechnologies.com\",\"from_email_address\":\"jbloggs@customernetwork.com\"}"

Available Parameters

Parameter

Parameter Type

Parameter Description

email_address_list

String

Semi-colon separated list of email addresses. This is mandatory.

email_host

String

The host to use for sending emails. Either an IP address or DNS style entry is acceptable for this parameter. This is mandatory.

email_port

Integer

The port to use for the SMTP host. This is the external SMTP server from which emails notifications are sent. This is mandatory.

email_host_user

String

Username to use for the SMTP host.

email_host_password

String

Password to use for the SMTP host.

email_use_tls

Boolean

Set this to 1 to use TLS as the SMTP secure connection type.

email_use_ssl

Boolean

Set this to 1 to use SSL as the SMTP secure connection type.

from_email_address

String

The email address that KEMP 360 Central uses to send email. This is mandatory.

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 10:49:30 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"created_at": "2018-01-09T18:43:48", "current_asl_instances": 0, "email_address_list": "jbloggs@kemptechnologies.com", "email_host": "2.2.2.2", "email_host_user": "", "email_port": 25, "email_use_ssl": false, "email_use_tls": false, "from_email_address": "jbloggs@customernetwork.com", "grace_period_active": false, "grace_period_expires": null, "id": 1, "pk": "1", "report_start_date": "2018-01-09T18:43:48", "resource_uri": "/api/v1/360/1/", "update_available": false, "updated_at": "2018-03-05T10:49:30.817437", "usage_report_bcc_address": "", "usage_report_via_alsi": true, "usage_report_via_smtp": false}

2.3.1.6 Download the System Logs

You can download syslogs by running the following command:

/api/v1/360/syslogs/?&api_key=APIKey&username=Username

Note that the system logs returned cover the period from when the KEMP 360 Central Virtual Machine was first booted to when the download system logs command is run.

Example Command

curl -k --dump-header - "https://KEMP360CentralIPAddress/api/v1/360/syslogs/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 11:12:57 GMT

Server: Apache

Cache-Control: no-cache

Content-Disposition: attachment; filename=syslog.log

X-Frame-Options: SAMEORIGIN

Vary: Accept,Accept-Encoding

Transfer-Encoding: chunked

Content-Type: text/plain

syslog

Jul 19 16:26:55 K360Central rsyslogd: [origin software="rsyslogd" swVersion="7.4.4" x-pid="1038" x-info="http://www.rsyslog.com"] start

Jul 19 16:26:55 K360Central rsyslogd-2307: warning: ~ action is deprecated, consider using the 'stop' statement instead [try http://www.rsyslog.com/e/2307 ]

Jul 19 16:26:55 K360Central rsyslogd: rsyslogd's groupid changed to 104

Jul 19 16:26:55 K360Central rsyslogd: rsyslogd's userid changed to 101

Jul 19 16:26:55 K360Central kernel: [    0.000000] Initializing cgroup subsys cpuset

Jul 19 16:26:55 K360Central kernel: [    0.000000] Initializing cgroup subsys cpu

Jul 19 16:26:55 K360Central kernel: [    0.000000] Initializing cgroup subsys cpuacct

2.3.1.7 Download the Audit Logs

You can download the audit logs by running the following command:

/api/v1/360/auditlogs/?&api_key=APIKey&username=Username

Note that the audit logs returned cover the period from when the KEMP 360 Central Virtual Machine was first booted to when the download audit logs command is run.

Example Command

curl -k --dump-header - "https://KEMP360CentralIPAddress/api/v1/360/auditlogs/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Example Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 11:14:29 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept,Accept-Encoding

Content-Disposition: attachment; filename=audit.log

Cache-Control: no-cache

Transfer-Encoding: chunked

Content-Type: text/plain

audit.log.1

[02/Mar/2018 07:30:03] INFO Database: HAPeer data written - {'preferred_master': False, 'ha_username': 'hauser', 'disable': False, 'retries': 0, 'last_heartbeat_sent': None, 'error_state': 1, 'last_heartbeat_received': None, 'ip_address': '127.0.0.1', 'state': 1, 'ssh_public_key': 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQChHyY7W65wHQFMrcO1S91VwpzD1Afi/5SLoN/SP1qLk2OjjXxCPd0PAGYE/lJjxmYk+pKNuXE4x++oItLjcv+tFY3M+HMCgqF/oRvspa3b5Wn2h7lHF5H3dEIrkyYalB362GuNp3rIdqwo6Lk4mlTbjbBpG3B2ZnabIY2ivOxhELl70JsTBq8abIN5ImpyQq3a0Sw+9r7WIp8jbQ+geiw5RIjbRwVJenlMbYBwpWzwyfozyUAgyyDEliRWpzjYkXN9Btqw1LCGMKTECOqqqThudn1J4g4PTC0uFrW+3DzpI4ATPgfQ7f4o+CuQJxYYNomPpDwE2vZWY1L0kGtxSQHd www-data@K360Central', 'last_sequence_sync': 0, 'last_sequence_no': 7306, 'id': 1, 'stats_timestamp_sync': 0, 'api_shared_key': '74246ec8d9253cde946e91aefa4f805be70b84fb', 'version': '1.21.0.1577', 'is_processing': True, 'local': True, 'last_heartbeat_response': None}

2.3.1.8 Download the Debug Logs

You can download the debug logs by running the following command:

/api/v1/360/debuglogs/?&api_key=APIKey&username=Username

Note that the debug logs returned cover the period from when the KEMP 360 Central Virtual Machine was first booted to when the download debug logs command is run.

Example Command

curl -k --dump-header - "https://KEMP360CentralIPAddress/api/v1/360/debuglogs/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Example Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 11:15:23 GMT

Server: Apache

Cache-Control: no-cache

Content-Disposition: attachment; filename=debug.log

X-Frame-Options: SAMEORIGIN

Vary: Accept,Accept-Encoding

Transfer-Encoding: chunked

Content-Type: text/plain

debug.log.1

[01/Mar/2018 10:00:07] ERROR [poll:193] Error connecting to device ARM-MELA-HA-0 (10.0.0.23:8443) due to HTTPSConnectionPool(host='10.0.0.23', port=8443): Max retries exceeded with url: /access/get?param=version (Caused by NewConnectionError('<requests.packages.urllib3.connection.VerifiedHTTPSConnection object at 0x7f3e1ade88d0>: Failed to establish a new connection: [Errno 113] No route to host',))

[01/Mar/2018 10:00:07] ERROR [poll:193] Error connecting to device ARM-MELA-HA-1 (10.0.0.29:8443) due to HTTPSConnectionPool(host='10.0.0.29', port=8443): Max retries exceeded with url: /access/get?param=version (Caused by NewConnectionError('<requests.packages.urllib3.connection.VerifiedHTTPSConnection object at 0x7f3e1adf4358>: Failed to establish a new connection: [Errno 113] No route to host',))

[01/Mar/2018 10:00:08] ERROR [poll:193] Error connecting to device ARM-LM-SPLA02 (10.0.0.21:8443) due to HTTPSConnectionPool(host='10.0.0.21', port=8443): Max retries exceeded with url: /access/get?param=version (Caused by NewConnectionError('<requests.packages.urllib3.connection.VerifiedHTTPSConnection object at 0x7f3e1adf4d30>: Failed to establish a new connection: [Errno 113] No route to host',))

[01/Mar/2018 10:00:10] ERROR [poll:193] Error connecting to device ARM-LM-SPLA03 (10.0.0.28:8443) due to HTTPSConnectionPool(host='10.0.0.28', port=8443): Max retries exceeded with url: /access/get?param=version (Caused by NewConnectionError('<requests.packages.urllib3.connection.VerifiedHTTPSConnection object at 0x7f3e1ade8470>: Failed to establish a new connection: [Errno 113] No route to host',))

2.3.2 Network Commands

The Network resource allows several operations to be performed in relation to the network(s) in KEMP 360 Central.

2.3.2.1 Retrieve Details of the Network(s)

You can use a GET method to retrieve details of the network(s).

/api/v1/network/?&api_key=APIKey&username=Username

The next example retrieves a full list of details for all networks that have been added to KEMP 360 Central. The output includes an id. This id number can be used to retrieve details of one specific network by entering the ID number after the resource name, for example - the following command displays details for the network with ID number 2:

/api/v1/network/2/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/network/2/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output 

HTTP/1.1 200 OK

Date: Wed, 15 Aug 2018 07:42:24 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"cidr": 24, "created_at": "2018-08-14T07:49:26", "id": 3, "info": {"broadcast": "10.35.29.255", "hosts": 254, "max": "10.35.29.254", "min": "10.35.29.1", "netmask": "255.255.255.0", "wildcard": "0.0.0.255"}, "iprange": "10.35.29.0", "loadmasters": [{"asl_instance": true, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": true}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": true}, "logs": {"read": true, "write": true}, "reboot": {"read": true, "write": true}, "restore": {"read": true, "write": true}, "shutdown": {"read": true, "write": true}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": true}, "virtual_services": {"read": true, "write": true}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-14T08:08:46", "critical_host_syslog": "", "datahash": "b'\\x8c\\x89?\\x8c\\x8f\\xb2\\x10\\xfb\\x84\\xa7\\xe58\\x8f9\\x96\\xf3\\xfb\\xe9S\\x17'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 5, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.3", "last_stats": null, "last_stats_time": "2018-08-14T08:08:46", "last_up": "2018-08-15T07:42:02", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/5/", "service_groups": ["/api/v1/servicegroup/33/", "/api/v1/servicegroup/34/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-14T09:42:07", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.2.40.0.15707.RELEASE", "warn_host_syslog": ""}, {"asl_instance": false, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": false}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": false}, "logs": {"read": true, "write": false}, "reboot": {"read": true, "write": false}, "restore": {"read": true, "write": false}, "shutdown": {"read": true, "write": false}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": false}, "virtual_services": {"read": true, "write": false}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-15T07:32:20", "critical_host_syslog": "", "datahash": "b'\\x19O\\xfb\\x86\\x88\\x90\\n\\xd9Nu^\\x8a\\x99\\xa5C\\x9e!pKK'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 8, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.138", "last_stats": null, "last_stats_time": "2018-08-15T07:32:17", "last_up": "2018-08-15T07:42:02", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/8/", "service_groups": ["/api/v1/servicegroup/35/", "/api/v1/servicegroup/38/", "/api/v1/servicegroup/39/", "/api/v1/servicegroup/40/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-15T07:32:21", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.1.35.4.15528.RELEASE", "warn_host_syslog": ""}], "network": 1, "nickname": null, "resource_uri": "/api/v1/network/3/", "updated_at": "2018-08-14T07:49:26"}

2.3.2.2 Show the Status of all Networks

You can use a GET method to retrieve details of the network(s).

/api/v1/network/?&api_key=APIKey&username=Username

The next example retrieves a full list of details for all networks that were added to KEMP 360 Central.

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/network/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Wed, 15 Aug 2018 07:41:26 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"meta": {"limit": 1000, "next": null, "offset": 0, "previous": null, "total_count": 2}, "objects": [{"cidr": 0, "created_at": "2018-01-31T08:26:10", "id": 1, "info": {"broadcast": "255.255.255.255", "hosts": 4294967294, "max": "255.255.255.254", "min": "0.0.0.1", "netmask": "0.0.0.0", "wildcard": "255.255.255.255"}, "iprange": "0.0.0.0", "loadmasters": [], "network": 0, "nickname": "All Networks", "resource_uri": "/api/v1/network/1/", "updated_at": "2018-01-31T08:26:10"}, {"cidr": 24, "created_at": "2018-08-14T07:49:26", "id": 3, "info": {"broadcast": "10.35.29.255", "hosts": 254, "max": "10.35.29.254", "min": "10.35.29.1", "netmask": "255.255.255.0", "wildcard": "0.0.0.255"}, "iprange": "10.35.29.0", "loadmasters": [{"asl_instance": true, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": true}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": true}, "logs": {"read": true, "write": true}, "reboot": {"read": true, "write": true}, "restore": {"read": true, "write": true}, "shutdown": {"read": true, "write": true}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": true}, "virtual_services": {"read": true, "write": true}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-14T08:08:46", "critical_host_syslog": "", "datahash": "b'\\x8c\\x89?\\x8c\\x8f\\xb2\\x10\\xfb\\x84\\xa7\\xe58\\x8f9\\x96\\xf3\\xfb\\xe9S\\x17'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 5, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.3", "last_stats": null, "last_stats_time": "2018-08-14T08:08:46", "last_up": "2018-08-15T07:41:03", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/5/", "service_groups": ["/api/v1/servicegroup/33/", "/api/v1/servicegroup/34/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-14T09:42:07", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.2.40.0.15707.RELEASE", "warn_host_syslog": ""}, {"asl_instance": false, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": false}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": false}, "logs": {"read": true, "write": false}, "reboot": {"read": true, "write": false}, "restore": {"read": true, "write": false}, "shutdown": {"read": true, "write": false}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": false}, "virtual_services": {"read": true, "write": false}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-15T07:32:20", "critical_host_syslog": "", "datahash": "b'\\x19O\\xfb\\x86\\x88\\x90\\n\\xd9Nu^\\x8a\\x99\\xa5C\\x9e!pKK'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 8, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.138", "last_stats": null, "last_stats_time": "2018-08-15T07:32:17", "last_up": "2018-08-15T07:41:03", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/8/", "service_groups": ["/api/v1/servicegroup/35/", "/api/v1/servicegroup/38/", "/api/v1/servicegroup/39/", "/api/v1/servicegroup/40/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-15T07:32:21", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.1.35.4.15528.RELEASE", "warn_host_syslog": ""}], "network": 1, "nickname": null, "resource_uri": "/api/v1/network/3/", "updated_at": "2018-08-14T07:49:26"}]}

2.3.2.3 Add a Network

You can use the POST method to add a new network to KEMP 360 Central.

/api/v1/network/?&api_key=APIKey&username=Username

Example Command

curl -X POST "https://KEMP360CentralIPAddress/api/v1/network/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k –v -d "{\"iprange\":\"10.154.50.0\",\"cidr\":\"16\"}"

Available Parameters

Parameter

Parameter Type

Parameter Description

nickname

String

A friendly name for the network.

CIDR

Integer

The Classless Inter-Domain Routing (CIDR) number of the network.

id

Integer

The unique ID number of the network. The network is automatically assigned the next increment of available ID numbers. KEMP recommends not setting the ID number as it is set automatically when a network is added.

iprange

String

The starting IP address of the network in the format IPAddress:CIDR.

network

Integer

Optional; To make the network a sub-network of another network, specify the relevant network or sub-network ID in this parameter.

Expected Output

HTTP/1.1 201 CREATED

Date: Mon, 05 Mar 2018 11:38:24 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Location: https://KEMP360CentralIPAddress/api/v1/network/2/

Transfer-Encoding: chunked

Content-Type: application/json

{"cidr": 16, "created_at": "2018-03-05T11:38:24.369962", "id": 2, "info": {"broadcast": "10.154.255.255", "hosts": 65534, "max": "10.154.255.254", "min": "10.154.0.1", "netmask": "255.255.0.0", "wildcard": "0.0.255.255"}, "iprange": "10.154.0.0", "loadmasters": [], "network": 1, "nickname": null, "resource_uri": "/api/v1/network/2/", "updated_at": "2018-03-05T11:38:24.370000"}

2.3.2.4 Update a Network

You can use the PUT method to update the details of a network.

/api/v1/network/NetworkID/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=Username

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/network/2/?api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin" -H "Content-Type: application/json" -k –v -d "{\"nickname\":\"Production\"}"

Available Parameters

Parameter

Parameter Type

Parameter Description

nickname

String

A friendly name for the network.

CIDR

Integer

The CIDR number of the network.

id

Integer

The unique ID number of the network. The network is automatically assigned the next increment of available ID numbers. KEMP recommends not setting the ID number because it is set automatically when a network is added.

loadmasters

Related

Details about the LoadMasters that have been added to the network.

Expected Output

HTTP/1.1 200 OK

Date: Mon, 05 Mar 2018 11:41:21 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"cidr": 16, "created_at": "2018-03-05T11:38:24", "id": 2, "info": {"broadcast": "10.154.255.255", "hosts": 65534, "max": "10.154.255.254", "min": "10.154.0.1", "netmask": "255.255.0.0", "wildcard": "0.0.255.255"}, "iprange": "10.154.0.0", "loadmasters": [], "network": 1, "nickname": "Production", "pk": "2", "resource_uri": "/api/v1/network/2/", "updated_at": "2018-03-05T11:41:21.540755"}

2.3.2.5 Delete a Network

You can use the DELETE method to remove a network from KEMP 360 Central.

/api/v1/network/NetworkID/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X DELETE "https://KEMP360CentralIPAddress/api/v1/network/13/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Fri, 02 Mar 2018 11:28:44 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3 LoadMaster Commands

The LoadMaster resource allows several operations to be performed in relation to the LoadMaster(s) that have been added to KEMP 360 Central.

2.3.3.1 Retrieve Details of the LoadMaster(s)

You can use a GET method to retrieve details of the LoadMaster(s).

/api/v1/loadmaster/?&api_key=APIKey&username=Username

The above example retrieves a full list of details for all LoadMasters were added to KEMP 360 Central. The output includes an id. This id number can be used to retrieve details of one specific LoadMaster by entering the ID number after the resource name, for example - the following command displays details for the LoadMaster with ID number 2:

/api/v1/loadmaster/2/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/2/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 09:36:45 GMT

Server: Apache

Cache-Control: no-cache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"asl_instance": true, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": true}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": true}, "logs": {"read": true, "write": true}, "reboot": {"read": true, "write": true}, "restore": {"read": true, "write": true}, "shutdown": {"read": true, "write": true}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": true}, "virtual_services": {"read": true, "write": true}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2017-07-20T17:14:24", "critical_host_syslog": "", "datahash": "b'\\xaf\\x9a\\xdf:\\t\\x14N\\xdd\\x82\\xe72<\\x10\\xe3\\xbdf\\x8e\\xf40\\x0b'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 2, "info_host_syslog": "10.0.0.16", "ip_address": "10.0.0.23", "last_stats": null, "last_stats_time": "2017-07-20T17:14:24", "last_up": "2017-12-01T13:21:02", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/2/", "nickname": "ARM-MELA-HA-0", "notice_host_syslog": "", "port": 8443, "public_access_address": "arm-mela-ha-0.westeurope.cloudapp.azure.com:8443", "resource_uri": "/api/v1/loadmaster/2/", "service_groups": ["/api/v1/servicegroup/4/", "/api/v1/servicegroup/5/", "/api/v1/servicegroup/6/"], "source": "from360", "status_uri": null, "system_status": "DOWN", "updated_at": "2017-12-01T13:00:05", "valid_parent_networks": [{"cidr": 24, "id": 2, "iprange": "10.0.0.0", "nickname": "AZURE ARM - West Europe", "resource_uri": "/api/v1/network/2/"}], "version": "7.2.39.0.15451.RELEASE", "warn_host_syslog": ""}

2.3.3.2 Show the Status of All LoadMasters in a Network

You can use a GET command to display the status of all LoadMasters in a network.

/api/v1/network/NetworkID/all_loadmasters/

The possible statuses are UP, DOWN and PROGRESS:

UP means the LoadMaster is contactable.

DOWN means the LoadMaster is uncontactable.

PROGRESS means the LoadMaster is down but is rebooting.

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/network/1/all_loadmasters/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Wed, 15 Aug 2018 07:38:24 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"loadmasters": [{"asl_instance": true, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": true}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": true}, "logs": {"read": true, "write": true}, "reboot": {"read": true, "write": true}, "restore": {"read": true, "write": true}, "shutdown": {"read": true, "write": true}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": true}, "virtual_services": {"read": true, "write": true}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-14T08:08:46", "critical_host_syslog": "", "datahash": "b'\\x8c\\x89?\\x8c\\x8f\\xb2\\x10\\xfb\\x84\\xa7\\xe58\\x8f9\\x96\\xf3\\xfb\\xe9S\\x17'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 5, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.3", "last_stats": null, "last_stats_time": "2018-08-14T08:08:46", "last_up": "2018-08-15T07:38:03", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/5/", "service_groups": ["/api/v1/servicegroup/33/", "/api/v1/servicegroup/34/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-14T09:42:07", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.2.40.0.15707.RELEASE", "warn_host_syslog": ""}, {"asl_instance": false, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": false}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": false}, "logs": {"read": true, "write": false}, "reboot": {"read": true, "write": false}, "restore": {"read": true, "write": false}, "shutdown": {"read": true, "write": false}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": false}, "virtual_services": {"read": true, "write": false}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-15T07:32:20", "critical_host_syslog": "", "datahash": "b'\\x19O\\xfb\\x86\\x88\\x90\\n\\xd9Nu^\\x8a\\x99\\xa5C\\x9e!pKK'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 8, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.138", "last_stats": null, "last_stats_time": "2018-08-15T07:32:17", "last_up": "2018-08-15T07:38:03", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/8/", "service_groups": ["/api/v1/servicegroup/35/", "/api/v1/servicegroup/38/", "/api/v1/servicegroup/39/", "/api/v1/servicegroup/40/"], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-15T07:32:21", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.1.35.4.15528.RELEASE", "warn_host_syslog": ""}]}                                    

2.3.3.3 Add a LoadMaster to KEMP 360 Central

You can use a POST method to add a LoadMaster to KEMP 360 Central.

/api/v1/loadmaster/?&api_key=APIKey&username=Username

Example Command

curl -X POST "https://KEMP360CentralIPAddress/api/v1/loadmaster/?api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin" -H "Content-Type: application/json" -k –v -d "{\"ip_address\":\"10.35.29.138\",\"lmusername\":\"bal\",\"password\":\"3fourall\",\"nickname\":\"standby\",\"network\":\"/api/v1/network/4/\"}"

Available Parameters

Parameter

Parameter Type

Parameter Description

id

Integer

This is the unique identifier (ID) number of the LoadMaster.

ip_address

String

The IP address of the LoadMaster.

lmusername

String

The LoadMaster username.

message_of_the_day

String

Message of the day text, which is displayed on the home page of the LoadMaster WUI. If no message is set, a default message of “This device is being managed by KEMP 360 Central” is displayed.

network

Related

The Uniform Resource Identifier (URI) of the network, that is /api/v1/network/NetworkID/

Note: You must add a network to KEMP 360 Central before a LoadMaster can be added.

nickname

String

A friendly name to identify the LoadMaster in KEMP 360 Central. If a nickname is not set the LoadMaster’s IP address is used as the nickname.

password

String

The password to access the LoadMaster.

syslogemergency

String

Use this option to set the host(s) that receives Emergency events only. Entries must be space separated. Up to 10 entries are supported.

syslogcritical

String

Use this option to set the host(s) that receives Emergency and Critical events. Entries must be space separated. Up to 10 entries are supported.

syslogerror

String

Use this option to set the host(s) that receives Emergency, Critical, and Error events. Entries must be space separated. Up to 10 entries are supported.

syslogwarn

String

Use this option to set the host(s) that receives Emergency, Critical, Error, and Warning events. Entries must be space separated. Up to 10 entries are supported.

syslognotice

String

Use this option to set the host(s) that receives Emergency, Critical, Error, Warning, and Notice events. Entries must be space separated. Up to 10 entries are supported.

sysloginfo

String

Use this option to set the host(s) that receives All events. Entries must be space separated. Up to 10 entries are supported.

Expected Output

HTTP/1.1 201 CREATED

Date: Tue, 14 Aug 2018 09:26:10 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Location: https://<<KEMP 360 Central IP Address>>/api/v1/loadmaster/7/

Transfer-Encoding: chunked

Content-Type: application/json

{"asl_instance": false, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": false}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": false}, "logs": {"read": true, "write": false}, "reboot": {"read": true, "write": false}, "restore": {"read": true, "write": false}, "shutdown": {"read": true, "write": false}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": false}, "virtual_services": {"read": true, "write": false}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-14T09:26:13.488491", "critical_host_syslog": "", "datahash": "b\"\\xeb\\x9dG\\x01\\xea\\tG\\x12\\xd3\\xa3\\x19\\x9c8\\x03\\x12>'\\xb3\\x89\\x82\"", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 7, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.138", "last_stats": null, "last_stats_time": "2018-08-14T09:26:10.720818", "last_up": "2018-08-14T09:26:13.465921", "lmusername": null, "management_interface": 0, "network": "/api/v1/network/3/", "nickname": "standby", "notice_host_syslog": "", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/7/", "service_groups": [], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-14T09:26:14.797900", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.1.35.4.15528.RELEASE", "warn_host_syslog": "", "warning_messages": []}

2.3.3.4 Update a LoadMaster

You can use the PUT method to update the LoadMaster details in the below table.

/api/v1/loadmaster/LoadMasterID/?&api_key=APIKey&username=Username

Example Command

curl -X PUT "https://KEMP360CentralIPAddress/api/v1/loadmaster/5/?api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin" -H "Content-Type: application/json" -k -v -d "{\"message_of_the_day\":\"the world is a vampire\"}"

Available Parameters

Parameter

Parameter Type

Parameter Description

id

Integer

This is the unique identifier (ID) number of the LoadMaster.

lmusername

String

The LoadMaster username.

message_of_the_day

String

Message of the day text which is displayed on the home page of the LoadMaster WUI. If no message is set a default message of “This device is being managed by KEMP 360 Central” is displayed.

nickname

String

A friendly name to identify the LoadMaster in KEMP 360 Central. If a nickname is not set the LoadMaster’s IP address is used as the nickname.

password

String

The password to access the LoadMaster.

Expected Output

HTTP/1.1 200 OK

Date: Tue, 14 Aug 2018 09:42:06 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"asl_instance": true, "aws_lb_name": null, "aws_region": null, "capabilities": {"backup": {"read": true, "write": true}, "device_config": {"read": true, "write": true}, "firmware": {"read": true, "write": true}, "logs": {"read": true, "write": true}, "reboot": {"read": true, "write": true}, "restore": {"read": true, "write": true}, "shutdown": {"read": true, "write": true}, "stats": {"read": true, "write": false}, "templates": {"read": true, "write": true}, "virtual_services": {"read": true, "write": true}}, "client_cert": true, "cluster_members": [], "cluster_node": null, "created_at": "2018-08-14T08:08:46", "critical_host_syslog": "", "datahash": "b'\\x8c\\x89?\\x8c\\x8f\\xb2\\x10\\xfb\\x84\\xa7\\xe58\\x8f9\\x96\\xf3\\xfb\\xe9S\\x17'", "device_type": 1, "emergency_host_syslog": "", "error_host_syslog": "", "ha_mode": 0, "ha_status": "", "ha_type": "", "id": 5, "info_host_syslog": "10.35.29.120", "ip_address": "10.35.29.3", "last_stats": null, "last_stats_time": "2018-08-14T08:08:46", "last_up": "2018-08-14T09:42:07.530471", "lmusername": null, "management_interface": 0, "message_of_the_day": "the world is a vampire", "network": "/api/v1/network/3/", "nickname": null, "notice_host_syslog": "", "pk": "5", "port": 443, "public_access_address": "", "resource_uri": "/api/v1/loadmaster/5/", "service_groups": [], "source": "admin", "status_uri": null, "system_status": "UP", "updated_at": "2018-08-14T09:42:07.557726", "valid_parent_networks": [{"cidr": 24, "id": 3, "iprange": "10.35.29.0", "nickname": null, "resource_uri": "/api/v1/network/3/"}], "version": "7.2.40.0.15707.RELEASE", "warn_host_syslog": "", "warning_messages": []}

2.3.3.5 Delete a LoadMaster

You can use the DELETE method to remove a LoadMaster from KEMP 360 Central.

/api/v1/loadmaster/LoadMasterID/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X DELETE "https://KEMP360CentralIPAddress/api/v1/loadmaster/1/?&api_key=de26b104526be42ec7e0454d363345a15be4c453&username=admin"

Expected Output

HTTP/1.1 204 NO CONTENT 

Date: Mon, 17 Aug 2015 09:23:20 GMT

Server: Apache/2.4.7 (Ubuntu)

Vary: Accept

X-Frame-Options: SAMEORIGIN

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.6 Reboot a LoadMaster

You can use the special reboot command to reboot a LoadMaster. The LoadMaster ID and reboot must be specified after loadmaster, as shown in the following example

/api/v1/loadmaster/LoadMasterID/reboot/?&api_key=APIKey&username=Username

To check the status of a LoadMaster during or after the reboot, run the command detailed in the Retrieve Details of the LoadMaster(s) section.

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/3/reboot/?&api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Tue, 06 Mar 2018 13:33:40 GMT

Server: Apache

Cache-Control: no-cache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "LoadMaster rebooting."}    

2.3.3.7 Reboot Multiple LoadMasters

You can use the POST command to reboot multiple LoadMasters simultaneously:

/api/v1/loadmaster/reboot_many/?username=Username&api_key=APIKey

Example Command

curl -k --dump-header - -X POST --data '[1,3]' "https:// 10.154.190.179/api/v1/loadmaster/reboot_many/?username=admin&api_key= de26b104526be42ec7e0454d363345a15be4c453"

1 and 3 are the IDs of the LoadMasters to be rebooted. To retrieve the LoadMaster IDs, run the command detailed in the Show the Status of All LoadMasters in a Network section.

Example Output

HTTP/1.1 200 OK

Date: Tue, 17 Nov 2015 13:36:33 GMT

Server: Apache/2.4.7 (Ubuntu)

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

[

    {

        "lm": 2,

        "message": "LoadMaster rebooting.",

        "status_code": 200

    },

    {

        "lm": 3,

        "message": "LoadMaster rebooting.",

        "status_code": 200

    }

]  

2.3.3.8 Update the LoadMaster Firmware

Before updating the LoadMaster firmware, a firmware update file must be available in KEMP 360 Central. The following sections provide details on each of the commands relating to firmware updates.

2.3.3.9 Retrieve Details of the Firmware Update Files

You can use the GET command to retrieve details of any firmware patch files that already exist in KEMP 360 Central:

/api/v1/patch/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/patch/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 12:22:48 GMT

Server: Apache

Cache-Control: no-cache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{

    "meta": {

        "limit": 20,

        "next": null,

        "offset": 0,

        "previous": null,

        "total_count": 1

    },

    "objects": [

        {

            "arch": "x86_64            ",

            "created_at": "2017-09-04T09:35:12",

            "id": 1,

            "patch": "./7.2.39.0.15451.RELEASE.20170705-1427-PATCH-VLM-AZURE",

            "resource_uri": "/api/v1/patch/1/",

            "updated_at": "2017-09-04T09:35:12",

            "version": "7.2.39.0.15451.RELEASE"

        }

    ]

}

The id number of the firmware patch file is displayed - this ID is needed when running the command to update the LoadMaster firmware.

2.3.3.10 Upload a Firmware Patch File

To upload a firmware patch file to KEMP 360 Central, use a command like the following:

/api/v1/patch/username=Username&api_key=APIKey

Example Command

curl -k --dump-header - -F "patch=@C:\temp\7.2.41.1.16002.RELEASE.20180215-0627-PATCH-64-MULTICORE" "https://KEMP360CentralIPAddress/api/v1/patch/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Available Parameters

The only available parameter for this command is patch. Please specify the path to the patch file, followed by the filename of the firmware update patch file. If you are using Windows, please enter double backslashes in the path.

Expected Output

HTTP/1.1 100 Continue

HTTP/1.1 201 CREATED

Date: Fri, 02 Mar 2018 12:32:46 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Location: https://<<KEMP 360 Central IP Address>>/api/v1/patch/2/

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.11 Delete a Firmware Patch File

You can use the DELETE method to remove a patch file from KEMP 360 Central.

/api/v1/patch/PatchID/?&api_key=APIKey&username=Username

Example Command

curl -k --dump-header - -X DELETE "https://KEMP360CentralIPAddress/api/v1/patch/2/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Fri, 02 Mar 2018 12:39:06 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.12 Update the LoadMaster

After uploading a firmware patch to KEMP 360 Central, run the following command to update the firmware on the LoadMaster:

/api/v1/loadmaster/LoadMasterID/firmware_update/FirmwareID/

The LoadMaster is automatically rebooted after the firmware update.

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/3/firmware_update/?&fw_id=1&api_key=1d2046ad8e89a301edca3ce1cc5152fae949a216&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Tue, 06 Mar 2018 13:28:27 GMT

Server: Apache

Cache-Control: no-cache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "LoadMaster firmware updated."}

2.3.3.13 Backup/Restore

To restore a LoadMaster’s settings, a backup file must first be uploaded to KEMP 360 Central.

Before a backup can be uploaded to KEMP 360 Central, users must first create the backup.

2.3.3.14 List all Backups

Use a GET command to retrieve a list of all available backups.

/api/v1/backup

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/backup/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin" 

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 10:23:40 GMT

Server: Apache

Cache-Control: no-cache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{

    "meta": {

        "limit": 20,

        "next": null,

        "offset": 0,

        "previous": null,

        "total_count": 1

    },

    "objects": [

        {

            "backup": "./10.0.0.30_2017-12-20_085826.backup",

            "created_at": "2017-12-20T08:58:27",

            "id": 1,

            "resource_uri": "/api/v1/backup/1/",

            "updated_at": "2017-12-20T08:58:27"

        }

    ]

}                               

2.3.3.15 List the Details of a Specific Backup Using an ID

Use a GET command to retrieve details of a specific backup.

/api/v1/backup/id/

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/backup/1/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Available Parameters

The only available parameter for this command is id. Users should first identify the ID number of the backup for which they want to retrieve details from. To retrieve the backup ID number, run the command to list all backups. For further information, refer to the List all Backups section.

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 10:26:29 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{

    "backup": "./10.0.0.30_2017-12-20_085826.backup",

    "created_at": "2017-12-20T08:58:27",

    "id": 1,

    "resource_uri": "/api/v1/backup/1/",

    "updated_at": "2017-12-20T08:58:27"

}

2.3.3.16 Back up a LoadMaster

KEMP 360 Central allows users to back up and restore LoadMaster settings.

To restore a LoadMaster’s settings, a backup file must first exist in KEMP 360 Central.

There are two ways to create a LoadMaster backup. The method to use depends on whether the LoadMaster to be backed up exists in KEMP 360 Central:

  • LoadMaster exists in KEMP 360 Central: Back up using KEMP 360 Central.
  • LoadMaster does not exist in KEMP 360 Central: Back up using the LoadMaster User Interface (UI) and upload the backup file to KEMP 360 Central.

2.3.3.17 Back up using KEMP 360 Central

You can use a GET command to back up a LoadMaster using KEMP 360 Central.

/api/v1/loadmaster/LoadMasterID/backup

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/19/backup/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Example Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 10:34:25 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Cache-Control: no-cache

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "LoadMaster backup created."}

2.3.3.18 Back up using the LoadMaster UI and Upload the Backup File to KEMP 360 Central

If the LoadMaster being backed up does not exist in KEMP 360 Central, the backup must be created using the LoadMaster rather than KEMP 360 Central.

After the backup file is downloaded from the LoadMaster, users should make a note of the path (on their local machine) to the backup file they want to upload to KEMP 360 Central.

You can use a POST command to upload a backup file to KEMP 360 Central.

/api/v1/backup/

Example Command

curl -k --dump-header - -F "backup=@C:\temp\LMBackups_arm-lm-spla39_2018_03_02.13_17" "https://KEMP360CentralIPAddress/api/v1/backup/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 100 Continue

HTTP/1.1 201 CREATED

Date: Fri, 02 Mar 2018 13:32:31 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Location: https://<<KEMP 360 Central IP Address>>/api/v1/backup/4/

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.19 Restore a Backup

You can use a GET command to restore an existing backup file (which exists in KEMP 360 Central) to a LoadMaster.

/api/v1/loadmaster/id/restore_backup/?backup_id=id  

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/5/restore_backup/?&backup_id=1&api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin"

Available Parameters

The ID of the LoadMaster and the ID of the backup are required parameters for restoring a backup:

Expected Output

HTTP/1.1 200 OK

Date: Tue, 14 Aug 2018 09:01:54 GMT

Server: Apache

Vary: Accept

Cache-Control: no-cache

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "LoadMaster backup restored."}

2.3.3.20 Delete a Backup

Use a DELETE command to delete a backup.

/api/v1/backup/id/

Example Command

curl -k --dump-header - -X DELETE "https://KEMP360CentralIPAddress/api/v1/backup/2/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Available Parameters

The only available parameter for this command is id.  Users should first identify the id number of the backup for which they wish to retrieve details.  To retrieve the backup ID number, run the command to list all backups. For further information, refer to the List all Backups section.

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Fri, 02 Mar 2018 10:40:34 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.21 Templates

2.3.3.22 Show Templates Available for a KEMP 360 Central Machine

Use a GET command to retrieve the list of templates available for a KEMP 360 Central machine.

/api/v1/template/

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/template/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

When running this command, enter the IPv4 address of the KEMP 360 Central machine.

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 10:45:25 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Cache-Control: no-cache

Transfer-Encoding: chunked

Content-Type: application/json

{

    "meta": {

        "limit": 20,

        "next": null,

        "offset": 0,

        "previous": null,

        "total_count": 2

    },

    "objects": [

        {

            "created_at": "2018-03-02T10:44:55",

            "id": 1,

            "resource_uri": "/api/v1/template/1/",

            "template": "./Exchange_2016_Additional.tmpl",

            "updated_at": "2018-03-02T10:44:55"

        },

        {

            "created_at": "2018-03-02T10:45:02",

            "id": 2,

            "resource_uri": "/api/v1/template/2/",

            "template": "./Exchange_2016_Core.tmpl",

            "updated_at": "2018-03-02T10:45:02"

        }

    ]

}

2.3.3.23 Show the Details of a Specific Template

Use a GET command to retrieve the details of a specific template.

/api/v1/template/id

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/template/1/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

When running this command, enter the IPv4 address of the KEMP 360 Central machine and the ID number of the template for which you require details. To retrieve the template ID, run the command which lists all templates. For further information, refer to the Show Templates Available for a KEMP 360 Central Machine section.

Expected Output

HTTP/1.1 200 OK

Date: Fri, 02 Mar 2018 10:47:53 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Cache-Control: no-cache

Transfer-Encoding: chunked

Content-Type: application/json

{

    "created_at": "2018-03-02T10:44:55",

    "id": 1,

    "resource_uri": "/api/v1/template/1/",

    "template": "./Exchange_2016_Additional.tmpl",

    "updated_at": "2018-03-02T10:44:55"

}

2.3.3.24 Upload a Template to KEMP 360 Central

You can use this command to upload a template to KEMP 360 Central.

Example Command

curl -k --dump-header - -F "template=@C:\temp\Exchange_2016_ESP.tmpl" "https://KEMP360CentralIPAddress/api/v1/template/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

Expected Output

HTTP/1.1 100 Continue

HTTP/1.1 201 CREATED

Date: Fri, 02 Mar 2018 10:52:37 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Vary: Accept

Location: https://<<KEMP 360 Central IP Address>>/api/v1/template/3/

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.3.25 Upload a Template to a LoadMaster

You can use a GET command to upload a template to a LoadMaster.

/api/v1/loadmaster/LoadMasterID/upload_template/?template_id=TemplateID/

Example Command

curl -k --dump-header - -X GET "https://KEMP360CentralIPAddress/api/v1/loadmaster/5/upload_template/?&template_id=1&api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin"

Expected Output

HTTP/1.1 200 OK

Date: Tue, 14 Aug 2018 08:50:17 GMT

Server: Apache

Cache-Control: no-cache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Transfer-Encoding: chunked

Content-Type: application/json

{"message": "Template ./Exchange_2016_ESP.tmpl uploaded."}

2.3.3.26 Delete a Template

You can use a DELETE command to delete a template.

/api/v1/template/id/

Example Command

curl -k --dump-header - -X DELETE "https://KEMP360CentralIPAddress/api/v1/template/1/?api_key=179d4f59c5ef97e7b6f7035eb296cdcefcc1e88f&username=admin"

When running this command, enter the IPv4 address of the KEMP 360 Central machine and the ID number of the template you want to delete. To retrieve the template ID, run the command that lists all templates. For further information, refer to the Show Templates Available for a KEMP 360 Central Machine section.

Expected Output

HTTP/1.1 204 NO CONTENT

Date: Fri, 02 Mar 2018 11:04:23 GMT

Server: Apache

Vary: Accept

X-Frame-Options: SAMEORIGIN

Content-Length: 0

Content-Type: text/html; charset=utf-8

2.3.4 License an Activation Server Local (ASL) LoadMaster

The following section outlines the commands to programmatically provision an ASL LoadMaster. Each of these commands immediately activates the LoadMaster.

This automatically creates a network in KEMP 360 Central. There is no requirement to create a network.

2.3.4.1 Activation Server IP

The aslactivate command updates the Activation Server IP Address and activates the LoadMaster:

curl –k –u username:password "https://LoadMasterIPAddress/access/aslactivate?aslipaddr=IPAddress"

The equivalent command from the Windows command line is:

curl "https://LoadMasterIPAddress/access/aslactivate?aslipaddr=KEMP360CentralIPAddress" -H "Content-Type: application/json" –k -v

This returns the settings of all the parameters that are configured. The same format response is returned in all cases.

curl –k –u username:password "https://LoadMasterIPAddress/access/aslactivate?aslipaddr=172.20.1.200"

<Response stat="200" code="ok">

<Success>

<Data>

<aslipaddr>172.20.1.200</aslipaddr>

<aslname>LM-ACT-SERVER-DEFAULT</aslname>

<aslport>8443</aslport>

</Data>

</Success>

</Response>

2.3.4.2 Activation Server Port

This command updates the Activate Server Port and activates the LoadMaster:

curl –k –u username:password https://LoadMasterIPAddress/access/aslactivate?aslport=Port

The equivalent command from the Windows command line is:

curl "https://LoadMasterIPAddress/access/aslactivate?aslport=Port" -H "Content-Type: application/json" –k -v

2.3.4.3 Activation Server Hostname

This command updates the Activation Server Hostname and activates the LoadMaster:

curl –k –u username:password https://LoadMasterIPAddress/access/aslactivate?aslname=FQDN

The equivalent command from the Windows command line is:

curl "https://LoadMasterIPAddress/access/aslactivate?aslname=FQDN" -H "Content-Type: application/json" –k -v

The default value for this field is always LM-ACT-SERVER-DEFAULT.

2.3.4.4 Set all Parameters

This command sets all the ASL LoadMaster settings (Server IP, Server Port, Server Hostname) and activates the LoadMaster:

curl –k –u username:password https://LoadMasterIPAddress/access/aslactivate?aslname=FQDN&aslport=Port&aslipaddr=IPAddress

The equivalent command from the Windows command line is:

curl "https://LoadMasterIPAddress/access/aslactivate?aslname=FQDN&aslport=Port&aslipaddr=IPAddress" -H "Content-Type: application/json" –k –v

2.3.4.5 Set the ASL LoadMaster Password

This command sets the ASL LoadMaster password (at the time of initial licensing):

curl -k –u username:password "https://LoadMasterIPAddress/access/set_initial_passwd?passwd=Password"

The equivalent command from the Windows command line is:

curl "https://LoadMasterIPAddress/access/set_initial_passwd?passwd=LoadMasterPassword" -H "Content-Type: application/json" –k –v -d "{\"username\":\"bal\",\"password\":\"LoadMasterPassword\"}"

The password is for the default administrator user (that is, the bal user). The password should contain at least eight alphanumeric characters.

2.3.5 ASL LoadMaster Commands

2.3.5.1 Detailed List of ASL Instances

You can retrieve the detailed list of ASL instances that are under KEMP 360 Central control using the API key and the following command:

Example Command

curl -X GET "https://KEMP360CentralIPAddress/api/v1/asl-instance/?api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"KEMP360CentralPassword\"}"

This returns an empty list, as below, if there are no ASL instances active.

{"meta": {"limit": 1000, "next": null, "offset": 0, "previous": null, "total_count": 0}, "objects": []}

The "limit" is set to 1000 by default and means that the API attempts to return information for 1000 ASL instances. This can be changed by using "&limit=n", where n defines the number of ASL instances information to be returned. For example, if you want the first 10 ASL LoadMaster details, then you use the following command:

curl -X GET "https://KEMP360CentralIPAddress/api/v1/asl-instance/?api_key=45e8679e3d71fba960e3796a73601dd206aef85e&username=admin&limit=10" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"KEMP360CentralPassword\"}"

When there are ASL LoadMasters active, the following information is returned:

HTTP/1.1 200 OK

Date: Wed, 15 Aug 2018 08:22:52 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"meta": {"limit": 1000, "next": null, "offset": 0, "previous": null, "total_count": 2}, "objects": [{"activation_date": "2018-08-15T07:54:09", "boot_time": "2018-03-05T13:34:46", "call_home_time": "2018-08-15T07:54:09", "created_at": "2018-02-10T10:57:17", "id": 1, "kill_time": "2018-08-14T08:08:03", "lm_version": "7.2.40.0.15707.RELEASE", "mac_address": "00505684e8ef", "resource_uri": "/api/v1/asl-instance/1/", "status": "ACTIVE", "updated_at": "2018-08-15T07:54:09", "vlm_name": "VMWARE"}, {"activation_date": "2018-08-14T08:08:46", "boot_time": "2018-03-05T13:34:47", "call_home_time": "2018-08-15T08:09:09", "created_at": "2018-02-10T11:02:17", "id": 2, "kill_time": "2018-08-14T07:05:19", "lm_version": "7.2.40.0.15707.RELEASE", "mac_address": "00505684e247", "resource_uri": "/api/v1/asl-instance/2/", "status": "ACTIVE", "updated_at": "2018-08-15T08:09:09", "vlm_name": "VMWARE"}]}

There is an "offset" parameter that defines the offset from the limit. For example, if the "limit" is set to 10 and the "offset" is set to 20, you get the ASL LoadMaster details from 10 to 30.

curl -X GET "https://KEMP360CentralIPAddress/api/v1/asl-instance/?api_key=45e8679e3d71fba960e3796a73601dd206aef85e&username=admin&limit=10&offset=20" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"KEMP360CentralPassword\"}"

2.3.5.2 Single ASL LoadMaster

The details for a single ASL LoadMaster instance can be retrieved

Example Command

curl -X GET "https://KEMP360CentralIPAddress/api/v1/asl-instance/1/?api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"KEMP360CentralPassword\"}"

The ‘1’ denotes the LoadMaster that the password is to be changed on. This information is available from the retrieve list command, parameter ‘id’.

Expected Output

HTTP/1.1 200 OK

Date: Wed, 15 Aug 2018 08:15:00 GMT

Server: Apache

X-Frame-Options: SAMEORIGIN

Cache-Control: no-cache

Vary: Accept

Transfer-Encoding: chunked

Content-Type: application/json

{"activation_date": "2018-08-15T07:54:09", "boot_time": "2018-03-05T13:34:46", "call_home_time": "2018-08-15T07:54:09", "created_at": "2018-02-10T10:57:17", "id": 1, "kill_time": "2018-08-14T08:08:03", "lm_version": "7.2.40.0.15707.RELEASE", "mac_address": "00505684e8ef", "resource_uri": "/api/v1/asl-instance/1/", "status": "ACTIVE", "updated_at": "2018-08-15T07:54:09", "vlm_name": "VMWARE"}

2.3.5.3 Download ASL Data

The detailed list of ASL LoadMasters is available with the following command.

Example Command

curl -X GET "https://KEMP360CentralIPAddress/api/v1/360/download_asl_data/?api_key=18f1c7933621e2e1e7738f178dccc603110d785c&username=admin" -H "Content-Type: application/json" -k -v -d "{\"username\":\"admin\",\"password\":\"KEMP360CentralPassword\"}"

Expected Output

Device ID,MAC Address,Status,Activation Date,Boot Time,Kill Time,LM Version

1,000d3a23c068,ACTIVE,2016-06-15 13:55:59+00:00,2016-06-15 13:15:47+00:00,,7.1.34.1.12856.RELEASE

If the ASL LoadMaster is removed from KEMP 360 Central, then the following information is returned.

Expected Output

Device ID,MAC Address,Status,Activation Date,Boot Time,Kill Time,LM Version

Device Removed,000d3a23c068,DISABLED,2016-06-15 13:55:59+00:00,2016-06-15 13:15:47+00:00,2016-06-15 14:36:20+00:00,7.1.34.1.12856.RELEASE

References

Unless otherwise specified, the following documents can be found at http://kemptechnologies.com/documentation.

Last Updated Date

This document was last updated on 12 March 2018.

Was this article helpful?

0 out of 0 found this helpful

Comments