Support Center

To better serve you during these uncertain times, we will be hosting a weekly support webinar. We’ll cover topics like LogicMonitor admin basics as well as ways to monitor a remote work environment. Tune in every Wednesday at 11:00am PST.

Sign up here
Submit a Ticket Icon Right Release Notes Icon Right LM Academy Icon Right

To better serve you during these uncertain times, we will be hosting a weekly support webinar. We’ll cover topics like LogicMonitor admin basics as well as ways to monitor a remote work environment. Tune in every Wednesday at 11:00am PST.

Sign up here
Support > Rest Api Developers Guide > V1 > Sdts > About The Sdt Resource

About the SDT Resource

The SDT resource allows you to programmatically manage your LogicMonitor scheduled down times (SDTs).

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

 

Using LogicMonitor’s REST API, you can:

 

Resource URI

/sdt/sdts

 

 

Resource Properties

All SDTs have the following properties:

Property

Description

Type
id The Id of the SDT. This value will be in the following format “XX_##” where XX will refer to the type of SDT and ## will refer to the number of SDTs of that type. String
sdtType 1 | 2 | 3 | 4
Indicates whether the SDT is one time or repeating 		Integer
admin The name of the user that created the SDT String
comment The notes associated with the SDT String
weekDay 1 | 2 | 3 | 4 | 5 | 6
The day of the week that the SDT will be active for a weekly SDT

  • 1: Sunday
  • 2: Monday
  • 3: Tuesday
  • 4: Wednesday
  • 5: Thursday
  • 6: Friday
  • 7: Saturday
 Integer
monthDay 1 | 2….| 31
The day of the month that the SDT will be active for a monthly SDT 		Integer
hour 1 | 2….| 24
The hour that the SDT will start for a repeating SDT (daily, weekly, or monthly) 		Integer
minute 1 | 2….| 60
The minute of the hour that the SDT should begin for a repeating SDT 		Integer
endHour 1 | 2….| 24
The hour that the SDT ends for a repeating SDT 		Integer
endMinute 1 | 2….| 60
The minute of the hour that the SDT ends for a repeating SDT 		Integer
duration The duration of the SDT in minutes Integer
startDateTimeOnLocal The date, time and time zone that the SDT will end at String
startDateTime The epoch time, in milliseconds, that the SDT will start Integer
endDateTimeOnLocal The date, time and time zone that the SDT will end at String
endDateTime The epoch time, in milliseconds, that the SDT will end Integer
isEffective true: the SDT is currently actice
false: the SDT is currently inactive 		Boolean
type The type resource that this SDT is for:
ServiceSDT | ServiceGroupSDT | DeviceSDT | DeviceGroupSDT | CollectorSDT | DeviceBatchJobSDT | DeviceDataSourceSDT | DeviceEventSourceSDT | DeviceDataSourceInstanceSDT | DeviceDataSourceInstanceGroupSDT 		String

 

Additional properties apply depending on the type of SDT – see the following sections:

Service SDTs

Service SDTs (i.e. SDTs with type=ServiceSDT) have the following additional properties:

Property

Description

Type
serviceId The Id of the service that the SDT applies to Integer
serviceName The name of the service that the SDT applies to String

 

Service Group SDTs

Service Group SDTs (i.e. SDTs with type=ServiceGroupSDT) have the following additional properties:

Property

Description

Type
serviceGroupId The Id of the service group that the SDT applies to Integer
serviceGroupName The name of the service group that the SDT applies to String

 

Device SDTs

 Device SDTs (type=DeviceSDT) have the following additional parameters:

Property

Description

Type
deviceId The id of the device that the SDT will be associated with Integer
deviceDisplayName The name of the device that this SDT will be associated with String

 

Device Group SDTs

Device Group SDTs (type=DeviceGroupSDT) have the following additional properties:

Property

Description

Type
deviceGroupId The id of the device group that the SDT will be associated with Integer
deviceGroupFullPath The full path of the device group that this SDT will be associated with String
dataSourceId The id of the datasource that this SDT will be associated with, for the specified group. dataSourceId 0 indicates all datasources. Integer
dataSourceName The name of the datasource that this SDT will be associated with, for the specified group. dataSourceName “All” indicates all datasources. String

 

Collector SDTs

Collector SDTs (type=CollectorSDT) have the following additional properties:

Property

Description

Type
collectorId The id of the collector that the SDT will be associated with Integer

 

Device Datasource SDTs

Datasource SDTs (type=DeviceDataSourceSD) have the following additional properties:

Property

Description
deviceDataSourceId The id of the device datasource that the SDT will be associated with Integer
deviceId The id of the device associated with the datasource that the SDT will apply to Integer
deviceDisplayName The display name of the device associated with the datasource that the SDT will apply to String
dataSourceName The name of the datasource that the SDT will apply to String

 

Device Eventsource SDTs

Eventsource SDTs (type=DeviceEventSourceSDT) have the following additional properties:

Property

Description
deviceEventSourceId The id of the device eventsource that the SDT will be associated with Integer
deviceId The id of the device associated with the eventsource that the SDT will apply to Integer
deviceDisplayName The display name of the device associated with the eventsource that the SDT will apply to String
eventSourceName The name of the eventsource that the SDT will apply to String

 

Device Batchjob SDTs

Batchjob SDTs (type=DeviceBatchJobSDT) have the following additional properties:

Property

Description
deviceBatchJobId The id of the device batchjob that the SDT will be associated with Integer
deviceId The id of the device associated with the batchjob that the SDT will apply to Integer
deviceDisplayName The display name of the device associated with the batchjob that the SDT will apply to String
batchJobName The name of the batchjob that the SDT will apply to String

 

Instance SDTs

Instance SDTs (type=DeviceDataSourceInstanceSDT) have the following additional properties:

Property

Description

Type
dataSourceInstanceId The id of the datasource instance that the SDT will be associated with Integer
deviceId The id of the device that the SDT will be associated with Integer

 

Instance Group SDTs

Instance Group SDTs (type=DeviceDataSourceInstanceGroup) have the following additional properties:

Property

Description

Type
deviceDataSourceInstanceGroupId The id of the device datasource instance group that the SDT will be associated with Integer
deviceDataSourceInstanceGroupName The name of the device datasource instance group that the SDT will be associated with String

 

In this Article: