Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

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 агент.

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

(объект) Возвращает объект, который содержит 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.