API: Device operations

ServerView / BrowserView device options list

ServerView / BrowserView Device Object example given in formatted JSON:

Fields description

Field

Type

Description

Avoid_Simultaneous_Checks

Boolean

Indicates if simultaneous check from the multiple monitoring locations is allowed. Available only for ServerView Devices

Example:
"Avoid_Simultaneous_Checks"true

Alert_Silence_Min

Int32

Defines time period in minutes when all alerts are disable

Example:
"Alert_Silence_Min": 46

False_Positive_Check

Boolean

When error detected we run series of checks to ensure it is not a false alert. Those checks may take some time, depending on the error type and number of tasks in the device. This may cause some delay in downtime alert. You can disable (“true” state) false positive check to ensure immediate downtime alert, but it may result in some “false” alerts. We recommend  NOT to disable “False positive check”

Example:
"False_Positive_Check"false

Locations

Array of int32

An array containing location IDs assigned to a specified device

Example:
"Locations": [1, 2, 4, 5, 8]

Send_Uptime_Alert

Boolean

When this option is enabled, you will receive an alert when all detected errors are resolved.

Example:
"Send_Uptime_Alert"false

Status_Description

String

READ ONLY field.Describing current device state.

Example:
"Status_Description""POSTPONED"

Postpone

Boolean

Monitoring can be set on a pause by postponing a device.

Example:
"Postpone"true,

Owner_Device_Id

Int32

This field reflects Owner Device ID.

Example:
"Owner_Device_Id": 8534

Frequency

Int32

This Field reflects monitoring frequency in minutes

Example:
"Frequency": 60

Filter_Id

Int32

This field reflects Filter ID assigned to a device.

Example:
"Filter_Id": 853

Scheduler_Id

Int32

This field reflects Scheduler ID assigned to a device.

Example:
"Scheduler_Id": 534

Notifications

Array of Objects

Indicates list of alert settings

Example #1:
"Notifications":
      {
      "E_Mail_Flag"true,
      "E_Mail_Address""demo@at.com",
      "E_Mail_TimeInterval_Min": 10
      }
Example #2:
"Notifications":
      {
      "Notification_Groups":
            [{
                  "Id": 608,
                  "Time_Shift_Min": 10
            }]
      }

E_Mail_Flag

Boolean

Defines if e-mail alert will be sent.

Example:
"E_Mail_Flag"false

E_Mail_Address

string

Specifies an email address for an email alerts

Example:
"E_Mail_Address""demo@company.com"

E_Mail_TimeInterval_Min

Int32

This field allows to set an interval between email alerts in minutes

Example:
"E_Mail_TimeInterval_Min": 15

WL_Device_Flag

Boolean

Defines if wireless device alert will be sent.

Example:
"WL_Device_Flag"false

WL_Device_Email_Address

String

This field specifies a wireless device, such as phone or pager, for alerts.

Example:
"WL_Device_Email_Address""wireless@company.com"

WL_Device_TimeInterval_Min

Int32

This field allows to set an interval between wireless device alerts in minutes

Example:
"WL_Device_TimeInterval_Min": 13

Pager_Flag

Boolean

Defines if pager alerts will be sent.

Example:
"Pager_Flag"true

Pager_Area_Code

String

Pager area Code

Example:
"Pager_Area_Code""917"

Pager_Phone

String

Pager Phone

Example:
"Pager_Phone""3214564"

Pager_Num_Code

String

Code for a numeric pagers

Example:
"Pager_Num_Code""225"

Pager_TimeInterval_Min

Int32

This field allows setting an interval between pager alerts in minutes

Example:
"Pager_TimeInterval_Min": 5

Phone_Flag

Boolean

Defines if phone call alerts will take place. To receive alerts via phone set value to “true” and specify phone number. Phone alerts are interactive, allowing you to postpone subsequent alerts once an alert in received.

Example:
"Phone_Flag"true

Phone_Area_Code

String

If the country code is “1” (for example, in the US, Canada, and Caribbean), enter the area code and number (for example, 952-5134349). For all other country codes, use the prefix “011”, the country code and the phone number (for example, 011-44-95-2244392).

Example:
"Phone_Area_Cde""952"

Phone_Phone

String

Phone number.

Example:
"Phone_Phone""5134349"

Phone_TimeInterval_Min

Int32

This field allows setting an interval between phone calls.

Example:
"Phone_TimeInterval_Min": 2

SMS_Flag

Boolean

Defines if SMS alerts will be sent.

Example:
"SMS_Flag"false

SMS_Phone

A phone number with a country code (for example: US – 1 952 513 4349; UK 449524 4392). Do NOT use an international dialing prefix, such as “011” in the number

Example:
"SMS_Phone""19525134349"

SMS_TimeInterval_Min

Int32

This field allows setting an interval between SMS alerts.

Example:
"SMS_TimeInterval_Min": 0

Script_Flag

Boolean

This field defines if alerting will be performed by a custom alert scripts

Example:
"Script_Flag"false

Script_Batch_File_Name

String

Custom Script filename. Script Have to be already installed at the server.

Example:
"Script_Batch_File_Name":"alerting.cs"

Script_TimeInterval_Min

Int32

This field allows setting an interval between custom script alerts.

Example:
"Script_TimeInterval_Min":5

Notification_Groups

Array of objects

Indicates active alert groups with their ID and time shift. Time shift is an option allows you to create an Alert Escalation process that is based on the duration of the error condition, For example, First notification group could be notified immediately, Second after 10-minutes of downtime and third group after 60-minutes of downtime. Alert Escalation time intervals range from immediate to three hours.

Example:
"Notification_Groups":
      [{
            "Id": 608,
            "Time_Shift_Min": 10
      }, {
            "Id": 609,
            "Time_Shift_Min": 20
      }]

Number_Of_Tasks

Int32

READ ONLY Field.Shows number of tasks under specified device.

Example:
"Number_Of_Tasks": 15

Id

Boolean

READ ONLY Field.Unique device ID.

Example:
"Avoid_Simultaneous_Checks"true

Platform_Id

Boolean

READ ONLY Field.Each Platform (ServerView, UserView etc.) has its own ID.

Example:
"Avoid_Simultaneous_Checks"true

Name

Boolean

Device name

Example:
"Avoid_Simultaneous_Checks"true