RPC API Developer's Guide

Verify a Device's Properties

Note that LogicMonitor does have an available REST API equivalent for this API call.

LogicMonitor's RPC API enables you to verify one or more properties belonging to a device with verifyProperties.

Note: As with all our API calls, authentication is required.

 

verifyProperties

URL:
https://accountName.logicmonitor.com/santaba/rpc/verifyProperties?c=accountName&u=user&p=password&hostId=hostIdNum&propName0=property0Name&propValue0=property0Value

 

Request Parameters: You can include the following as query parameters in a verifyProperties request:

Parameter

Type

Description

hostId Integer Required. The Unique ID of the Host

To get a hostId in the UI: navigate to the device & select the focus icon- the id is in the URL as d-##.

propName{0..n} String Optional. The name of the device property to be verified
propValue{0..n} String Required if propName is specified. The value of the device property to be verified

 

All outputs will be in the format: { [status], [data], [errmsg] }, where status is the status of the response, errmsg is the error message associated with the response, and the data object includes the following:

Value

Description

match Boolean identifying if the Device Property Value matches the Value specified in the request

 

Example

Request:
curl "https://apiAccount.logicmonitor.com/santaba/rpc/verifyProperties?c=apiAccount&u=apiUser&p=example&hostId=208&propName0=system.location&propValue0=12%20e%20carrillo" 
Response:
{
  "status": 200,
  "data": {"match": true},
  "errmsg": "OK"
}