[comment]: # translation:outdated

[comment]: # ({c9bc126a-c9bc126a})
# task.create

[comment]: # ({/c9bc126a-c9bc126a})

[comment]: # ({0e3179d3-0e3179d3})
### Описание

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

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

::: noteclassic
Этот метод доступен только пользователю с типом доступа *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles).
:::

[comment]: # ({/0e3179d3-0e3179d3})

[comment]: # ({new-2574c234})
### Параметры

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

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

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

[comment]: # ({/new-2574c234})

[comment]: # ({ab87ce2a-ab87ce2a})
### Возвращаемые значения

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

[comment]: # ({/ab87ce2a-ab87ce2a})

[comment]: # ({b41637d2-b41637d2})
### Примеры

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({new-5c5fa6f1})
#### Создание задачи

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

Запрос:

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

Ответ:

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

[comment]: # ({/new-5c5fa6f1})

[comment]: # ({new-d87c906b})
### Исходный код

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

[comment]: # ({/new-d87c906b})

[comment]: # ({be350bd3-be350bd3})
### Источник

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

[comment]: # ({/be350bd3-be350bd3})