task.create

Описание

object task.create(object/array tasks)

Этот метод позволяет создавать задачи.

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

Параметры

(object/array) Задача для создания.

Метод принимает задачи со стандартными свойствами задачи.

Обратите внимание, что задачи «Выполнить сейчас» можно создавать только для следующих типов элементов данных/правил обнаружения:

  • Агент Zabbix (пассивный)
  • Простая проверка
  • SNMP-агент (v1/v2/v3)
  • Внутренний Zabbix
  • Внешняя проверка
  • Монитор базы данных
  • HTTP-агент
  • IPMI-агент
  • SSH-агент
  • TELNET-агент
  • JMX-агент
  • Вычисляемый
  • Зависимый элемент данных
  • Скрипт
  • Браузер
  • Запрос телеметрии

Если элемент данных/правило обнаружения имеет тип «Зависимый элемент данных», его мастер-элемент данных также должен иметь один из перечисленных выше типов.

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

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

Примеры

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

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

Запрос:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 6,
            "request": {
                "itemid": "10092"
            }
        },
        {
            "type": 6,
            "request": {
                "itemid": "10093"
            }
        }
    ],
    "id": 1
}

Ответ:

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

Создайте задачу «Обновить конфигурацию прокси» для двух прокси.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 2,
            "request": {
                "proxyids": ["10459", "10460"]
            }
        }
    ],
    "id": 1
}

Ответ:

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

Создайте задачу «Диагностическая информация».

Запрос:

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 1,
            "request": {
                "alerting": {
                    "stats": [
                        "alerts"
                    ],
                    "top": {
                        "media.alerts": 10
                    }
                },
                "lld": {
                    "stats": "extend",
                    "top": {
                        "values": 5
                    }
                }
            },
            "proxyid": 0
        }
    ],
    "id": 1
}

Ответ:

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

См. также

Источник

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