Available Methods

Connection Sample

Example ServerView/BrowserView Device JSON Object
{
    "Avoid_Simultaneous_Checks": false,
    "Alert_Silence_Min": 28,
    "False_Positive_Check": false,
    "Locations": [
        1,
        4,
        6,
        14,
        15,
        17,
        19,
        23,
        43,
        71,
        73
    ],
    "Tags": [
        "my_device"
    ],
    "ContextParams": [],
    "Send_Uptime_Alert": false,
    "Status_Description": "POSTPONED",
    "Postpone": true,
    "Owner_Device_Id": 0,
    "Frequency": 10800,
    "Filter_Id": 7791,
    "Scheduler_Id": 0,
    "Notifications": {
        "E_Mail_Flag": false,
        "E_Mail_Address": null,
        "E_Mail_TimeInterval_Min": 0,
        "WL_Device_Flag": false,
        "WL_Device_Email_Address": null,
        "WL_Device_TimeInterval_Min": 0,
        "Pager_Flag": false,
        "Pager_Area_Code": null,
        "Pager_Phone": null,
        "Pager_Num_Code": null,
        "Pager_TimeInterval_Min": 0,
        "Phone_Flag": false,
        "Phone_Area_Code": null,
        "Phone_Phone": null,
        "Phone_TimeInterval_Min": 0,
        "SMS_Flag": false,
        "SMS_Phone": null,
        "SMS_TimeInterval_Min": 0,
        "Script_Flag": false,
        "Script_Batch_File_Name": null,
        "Script_TimeInterval_Min": 0,
        "SNMP_TimeInterval_Min": 0,
        "Teams_TimeInterval_Min": 0,
        "Slack_TimeInterval_Min": 0,
        "AlertOps_TimeInterval_Min": 0,
        "PagerDuty_TimeInterval_Min": 0,
        "Notification_Groups": []
    },
    "Id": 47432,
    "Number_Of_Tasks": 1,
    "WaitingForApproval": false,
    "Platform_Id": 1,
    "Package_Id": 52,
    "Name": "FullPageDomain.cs"
}

Fields Description

Use these fields to specify information about a Device in your API requests.

Field

Type

Description

Avoid_Simultaneous_Checks

boolean

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

Example:
"Avoid_Simultaneous_Checks"true

Alert_Silence_Min

int32

READ-ONLY. Defines time period in minutes when all alerts are disabled. To disable alerts, use API: Disable Alerts for Device or API: Disable Alerts for Several Devices.

Example:
"Alert_Silence_Min": 46

False_Positive_Check

boolean

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

Example:
"False_Positive_Check"false

Locations

array of int32

An array containing location IDs assigned to a specified device. At least one location must be specified in the requests.

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

Tags

array of string

An array containing names of the tags assigned to a specified device.

Example:
"Tags": ["green", "red", "black"]

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. Describing current device state.

Example:
"Status_Description""POSTPONED"

Postpone

boolean

Monitoring can be set on pause by postponing a device.

Example:
"Postpone"true,

Owner_Device_Id

int32

This field reflects the Owner Device ID.

Example:
"Owner_Device_Id": 8534

Frequency

int32

This field reflects monitoring frequency in seconds.

Example:
"Frequency": 10800

Filter_Id

int32

This field reflects the Filter ID assigned to a device.

Example:
"Filter_Id": 853

Scheduler_Id

int32

This field reflects the Scheduler ID assigned to a device.

Example:
"Scheduler_Id": 534

Notifications

array of objects

Indicates a 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 an email alert will be sent.

Example:
"E_Mail_Flag"false

E_Mail_Address

string

Specifies an email address for email alerts.

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

E_Mail_TimeInterval_Min

int32

This field allows setting an interval between email alerts in minutes

Example:
"E_Mail_TimeInterval_Min": 15

WL_Device_Flag

boolean

Defines if a wireless device alert will be sent.

Example:
"WL_Device_Flag"false

WL_Device_Email_Address

string

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

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

WL_Device_TimeInterval_Min

int32

This field allows setting 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 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 the value to “true” and specify the phone number. Phone alerts are interactive, allowing you to postpone subsequent alerts once an alert is received.

Example:
"Phone_Flag"true

Phone_Area_Code

string

If the country code is “1” (for example, in the US, Canada, and the 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

string 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 script.

Example:
"Script_Flag"false

Script_Batch_File_Name

string

Custom Script filename. Script has to be already installed on 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. Timeshift is an option that allows you to create an Alert Escalation process that is based on the duration of the error condition, For example, the First notification group can be notified immediately, the Second – after 10-minutes of downtime, and the 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 the number of tasks under the specified device.

Example:
"Number_Of_Tasks": 15

Id

int32

READ ONLY Field. The unique device ID. Assigned automatically upon a new device creation. Use to specify a device in requests.

Example:
"Id": 8533

Platform_Id

int32

READ ONLY Field. Each Platform (ServerView, UserView, etc.) has its own ID. See how to get platforms’ IDs here.

Example:
"Platform_Id": 1

Name

string

The name of the device.

Example:
"Name": "new name"