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.
Примеры
Создание задачи
Создайте задачу 'Execute now' для элемента данных и правила обнаружения низкого уровня.
{
"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
}
Создайте задачу 'Refresh proxy configuration' для двух прокси.
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 2,
"request": {
"proxyids": ["10459", "10460"]
}
}
],
"id": 1
}
Ответ:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"1"
]
},
"id": 1
}
Создайте задачу 'Diagnostic information'.
{
"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.