task.create

Описание

object task.create(объект/массив tasks)

Этот метод позволяет создать новую задачу (например, сбор диагностических данных, проверку элементов или правил низкоуровневого обнаружения без перезагрузки конфигурации).

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект) Создаваемые задачи.

Этот метод принимает следующие параметры.

Параметр	Тип	Описание
type (требуется)	целое число	Тип задачи. Возможные значения: 6 - Проверить сейчас.
itemids (требуется)	строка/массив	ID элементов данных и правил низкоуровневого обнаружения. Элементы данных и правила обнаружения должны быть следующих типов: 0 - Zabbix агент; 1 - SNMPv1 агент; 3 - простая проверка; 4 - SNMPv2 агент; 5 - Zabbix внутренний; 6 - SNMPv3 агент; 8 - Zabbix агрегированный; 10 - внешняя проверка; 11 - монитор баз данных; 12 - IPMI агент; 13 - SSH агент; 14 - TELNET агент; 15 - вычисляемый; 16 - JMX агент.

If item or discovery ruls is of type Dependent item, then top level master item must be of type: - Zabbix agent - SNMPv1/v2/v3 agent - Simple check - Internal check - External check - Database monitor - HTTP agent - IPMI agent - SSH agent - TELNET agent - Calculated check - JMX agent

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных задач, указанных в свойстве taskids. Одна задача создается по каждому элементу данных и правилу низкоуровневого обнаружения. Порядок возвращаемых ID совпадает с порядком переданных itemids.

Примеры

Создание задачи

Создание задачи проверить сейчас по двум элементам. Один из них элемент данных, второй правило низкоуровневого обнаружения.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": {
               "type": "6",
               "itemids": ["10092", "10093"],
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1",
                   "2"
               ]
           },
           "id": 1
       }

Исходный код

CTask::create() в frontends/php/include/classes/api/services/CTask.php.

Источник

CTask::create() в ui/include/classes/api/services/CTask.php.

Documentation