REST API Developer's Guide

Update a Datasource Instance

You can use LogicMonitor's REST API to programmatically update instances for datasources that don't have Active Discovery enabled.  

Notes:

  • As with all of our API calls, authentication is required.
  • Consistent with HTTP standards, fields omitted from a PUT request will revert back to their default values.

 

HTTP Method: PUT

URI: /device/devices/{deviceId}/devicedatasources/{deviceDatasourceId}/instances/{instanceId}

Where:

  • {deviceId} is the device id, which you can get from a GET request to the devices resource
  • {deviceDatasourceId} is the device datasource id, which you can get from a GET request to the device datasources resource
  • {instanceId} is the instance id

Request Parameters: You can include the following parameters in your POST request:

Property

Description

Required?

Type

groupId The id of the instance group associated with the datasource instance Yes Integer
displayName The instance alias. This is the descriptive name of the instance, and should be unique for the device/datasource combination. Yes String
description The description of the datasource instance No String
wildValue The variable part of the instance, used to query data from a device. For example, variable part of the SNMP OID tree. This value must be unique for the device/datasource combination, unless two-dimensional active discovery is used. Yes String
wildValue2 Only used for two dimensional active discovery. When used, during Active Discovery runs, the token ##WILDVALUE## is replaces with the value of ALIAS and the token ##WILDVALUE2## is replaced with the value of the second part alias. This value must be unique for the device/datasource/WILDVALUE combination. No String
disableAlerting Whether or not alerting is disabled for the instance No. Defaults to false. Boolean
stopMonitoring Whether or not monitoring is disabled for the instance No. Defaults to false. Boolean

 

Example

The following Python script updates instance 144279093 & disables alerting:

#!/bin/env python

import requests
import json
import hashlib
import base64
import time
import hmac

#Account Info
AccessId ='48v2wRzfK94y53sq5EuF'
AccessKey ='H_D9i(f5~B^U36^K6i42=^nS~e75gy382Bf6{)P+'
Company = 'api'

#Request Info
httpVerb ='PUT'
resourcePath = '/device/devices/56/devicedatasources/3294/instances/144279093'
queryParams =''
data = '{"groupId":10354,"wildValue":"www.google.com","displayName":"apiInstancess","disableAlerting":true}'

#Construct URL 
url = 'https://'+ Company +'.logicmonitor.com/santaba/rest' + resourcePath +queryParams

#Get current time in milliseconds
epoch = str(int(time.time() * 1000))

#Concatenate Request details
requestVars = httpVerb + epoch + data + resourcePath

#Construct signature
signature = base64.b64encode(hmac.new(AccessKey,msg=requestVars,digestmod=hashlib.sha256).hexdigest())

#Construct headers
auth = 'LMv1 ' + AccessId + ':' + signature + ':' + epoch
headers = {'Content-Type':'application/json','Authorization':auth}

#Make request
response = requests.put(url, data=data, headers=headers)

#Print status and body of response
print 'Response Status:',response.status_code
print 'Response Body:',response.content