REST API Developer's Guide

Get DataSource Instance Groups

You can use LogicMonitor's REST API to programmatically get datasource instance groups.  

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

 

Get a list of datasource instance groups

HTTP Method: GET

URI: /device/devices/{deviceId}/devicedatasources/{deviceDatasourceId}/groups

Where:

Request Parameters: By default, a list of 50 instances will be returned. You can include sort, filter, fields, size and offset parameters in your request to control what data is included in the response and how it is formatted.

Property

Syntax

Description

Example URI

sort sort={+ or -}property Sorts the response by the property specified in either increasing (+) or decreasing (-) order /device/devices/12/devicedatasources/98/groups?sort=-id
filter filter=property{operator}value Filters the response according to the operator and value specified. Note that you can use * to match on more than one character. You can use the '.' character to filter values within an object (e.g. custom properties), and multiple filters can be separated by a comma.

Operators include:
  • Greater than or equals: >:
  • Less than or equals: <:
  • Greater than: >
  • Less than: <
  • Does not equal: !:
  • Equals: :
  • Includes: ~
  • Does not include: !~
/device/devices/43/devicedatasources/76/groups?filter=name~prod*
fields fields={list of properties separated by commas} Filters the response to only include the following fields for each object /device/devices/9/devicedatasources/24/groups?fields=name,id
size size=integer The number of results to display. Max is 1000. /device/devices/87/devicedatasources/54/groups?size=5
offset offset=integer The number of results to offset the displayed results by /device/devices/34/devicedatasources/90/groups?offset=2

Get information about a particular datasource instance

HTTP Method: GET

URI: /device/devices/{deviceId}/devicedatasources/{deviceDatasourceId}/groups/{groupId}

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
  • {groupId} is the instance group id

Request Parameters: You can include a fields parameter in your request to control what data is included in the response and how it is formatted.

Property

Syntax

Description

Example URI

fields fields={list of properties separated by commas} Filters the response to only include the following fields for each object /device/devices/9/devicedatasources/24/groups/45?fields=name,id