Доступные методы

Пример подключения

Пример объекта JSON устройства ServerView/BrowserView
Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"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"
}
{ "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" }
{
    "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"
}

Описание полей

Эти поля используются для указания сведений об Устройстве в запросах API.

поле

Type

описание

Avoid_Simultaneous_Checks

булев

Указывает, разрешена ли одновременная проверка из нескольких мест мониторинга. Доступно только для устройств ServerView.

пример:
"Avoid_Simultaneous_Checks": true

Alert_Silence_Min

int32

ТОЛЬКО ДЛЯ ЧТЕНИЯ. Определяет период времени в минутах, когда все оповещения отключены. Чтобы отключить оповещения, используйте API: Отключить оповещения для устройства или API: Отключить оповещения для нескольких устройств.

пример:
"Alert_Silence_Min": 46

False_Positive_Check

булев

При обнаружении ошибки мы проводим серию проверок, чтобы убедиться, что это не ложное предупреждение. Эти проверки могут занять некоторое время, в зависимости от типа ошибки и количества задач в устройстве. Это может привести к некоторой задержке оповещения о простое. Вы можете отключить ложноположительную проверку («истинное» состояние), чтобы обеспечить немедленное оповещение о простое, но это может привести к некоторым «ложным» предупреждениям. Мы рекомендуем НЕ отключать «Ложноположительную проверку».

пример:
"False_Positive_Check": false

Местонахождения

массив int32

Массив, содержащий идентификаторы расположения, назначенные указанному устройству. В запросах должно быть указано хотя бы одно местоположение.

пример:
"Locations": [1, 2, 4, 5, 8]

Теги

массив строки

Массив, содержащий имена тегов, назначенных указанному устройству.

пример:
"Tags": ["green", "red", "black"]

Send_Uptime_Alert

булев

Когда эта опция включена, вы получите оповещение, когда все обнаруженные ошибки будут устранены.

пример:
"Send_Uptime_Alert": false

Status_Description

струна

ТОЛЬКО ДЛЯ ЧТЕНИЯ. Описание текущего состояния устройства.

пример:
"Status_Description": "POSTPONED"

откладывать

булев

Мониторинг можно поставить на паузу, отложив устройство.

пример:
"Postpone": true,

Owner_Device_Id

int32

В этом поле отражается идентификатор устройства-владельца.

пример:
"Owner_Device_Id": 8534

Частота

int32

Это поле отражает частоту мониторинга в секундах.

пример:
"Frequency": 10800

Filter_Id

int32

Это поле отражает идентификатор фильтра, назначенный устройству.

пример:
"Filter_Id": 853

Scheduler_Id

int32

Это поле отражает идентификатор планировщика, назначенный устройству.

пример:
"Scheduler_Id": 534

Уведомления

массив объектов

Указывает список параметров оповещений.

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

E_Mail_Flag

булев

Определяет, будет ли отправлено оповещение по электронной почте.

пример:
"E_Mail_Flag": false

E_Mail_Address

струна

Указывает адрес электронной почты для оповещений по электронной почте.

пример:
"E_Mail_Address": "demo@company.com"

E_Mail_TimeInterval_Min

int32

Это поле позволяет установить интервал между оповещениями по электронной почте в минутах

пример:
"E_Mail_TimeInterval_Min": 15

WL_Device_Flag

булев

Определяет, будет ли отправлено предупреждение о беспроводном устройстве.

пример:
"WL_Device_Flag": false

WL_Device_Email_Address

струна

В этом поле указывается беспроводное устройство, например телефон или пейджер, для оповещений.

пример:
"WL_Device_Email_Address": "wireless@company.com"

WL_Device_TimeInterval_Min

int32

Это поле позволяет установить интервал между оповещениями беспроводных устройств в минутах.

пример:
"WL_Device_TimeInterval_Min": 13

Pager_Flag

булев

Определяет, будут ли отправлены предупреждения пейджера.

пример:
"Pager_Flag": true

Pager_Area_Code

струна

Пейджер код города.

пример:
"Pager_Area_Code": "917"

Pager_Phone

струна

Пейджер телефон.

пример:
"Pager_Phone": "3214564"

Pager_Num_Code

струна

Код для числовых пейджеров.

пример:
"Pager_Num_Code": "225"

Pager_TimeInterval_Min

int32

Это поле позволяет установить интервал между оповещениями пейджера в минутах.

пример:
"Pager_TimeInterval_Min": 5

Phone_Flag

булев

Определяет, будут ли происходить оповещения о телефонных звонках. Для получения оповещений по телефону установите значение «true» и укажите номер телефона. Телефонные оповещения являются интерактивными, что позволяет откладывать последующие оповещения после получения оповещения.

пример:
"Phone_Flag": true

Phone_Area_Code

струна

Если код страны равен «1» (например, в США, Канаде и странах Карибского бассейна), введите код города и номер (например, 952-5134349). Для всех остальных кодов стран используйте префикс «011», код страны и номер телефона (например, 011-44-95-2244392).

пример:
"Phone_Area_Cde": "952"

Phone_Phone

струна

Номер телефона.

пример:
"Phone_Phone": "5134349"

Phone_TimeInterval_Min

int32

Это поле позволяет установить интервал между телефонными звонками.

пример:
"Phone_TimeInterval_Min": 2

SMS_Flag

булев

Определяет, будут ли отправлены SMS-оповещения.

пример:
"SMS_Flag": false

SMS_Phone

струна Номер телефона с кодом страны (например: США — 1 952 513 4349; Великобритания 449524 4392). НЕ используйте в номере префикс международного набора, например «011».

пример:
"SMS_Phone": "19525134349"

SMS_TimeInterval_Min

int32

Это поле позволяет установить интервал между SMS-оповещениями.

пример:
"SMS_TimeInterval_Min": 0

Script_Flag

булев

Это поле определяет, будет ли оповещение выполняться пользовательским сценарием оповещения.

пример:
"Script_Flag": false

Script_Batch_File_Name

струна

Пользовательское имя файла скрипта. Скрипт должен быть уже установлен на сервере.

пример:
"Script_Batch_File_Name":"alerting.cs"

Script_TimeInterval_Min

int32

Это поле позволяет установить интервал между пользовательскими предупреждениями скрипта.

пример:
"Script_TimeInterval_Min":5

Notification_Groups

массив объектов

Указывает активные группы оповещения с их идентификатором и сменой времени. Timeshift — это опция, которая позволяет создать процесс эскалации предупреждений, основанный на длительности состояния ошибки, например, первая группа уведомлений может быть уведомлена немедленно, вторая — через 10 минут простоя, а третья группа — после 60 минут простоя. Интервалы времени оповещения эскалации варьируются от трех до трех часов.

пример:
"Notification_Groups":
[{
"Id": 608,
"Time_Shift_Min": 10
}, {
"Id": 609,
"Time_Shift_Min": 20
}]

Number_Of_Tasks

int32

READ ТОЛЬКО поле. Показывает количество задач на указанном устройстве.

пример:
"Number_Of_Tasks": 15

идентификатор

int32

READ ТОЛЬКО поле. Уникальный идентификатор устройства. Назначается автоматически при создании нового устройства. Используется для указания устройства в запросах.

пример:
"Id": 8533

Platform_Id

int32

READ ТОЛЬКО поле. Каждая платформа (ServerView, UserView и т. д.) имеет свой собственный идентификатор. Узнайте, как получить идентификаторы платформ здесь.

пример:
"Platform_Id": 1

имя

струна

Имя устройства.

пример:
"Name": "new name"