update_job
Метод update_job используется для создания, редактирования или удаления заданий.
svc=resource/update_job¶ms={
"itemId":<long>,
"id":<long>,
"callMode":"<text>",
"n":"<text>",
"d":"<text>",
"r":"<text>",
"at":<uint>,
"m":<uint>,
"fl":<uint>, /* необязательный: 1 — удалить задание после первого выполнения, 0 — сохранить задание. По умолчанию: 0 */
"tz":<int>,
"l":"<text>",
"e":<bool>,
"sch":{
"f1":<uint>,
"f2":<uint>,
"t1":<uint>,
"t2":<uint>,
"m":<uint>,
"y":<uint>,
"w":<uint>
},
"act":{
"t":"<text>",
"p":{
"<text>":"<text>",
...
}
}
}
Параметры
| Название | Описание |
|---|---|
| itemId | ID ресурса. |
| id | ID задания (0 — создать). |
| callMode | Действие: создание, редактирование, удаление. |
Другие параметры необходимы только для создания и редактирования. См. страницу get_job_data.
Объекты и группы объектов, указанные в параметре units действия задания (act.p.units), добавляются в задание, только если у создателя ресурса есть право доступа Использование объекта в уведомлениях, заданиях, маршрутах, ретрансляторах к ним. Остальные объекты пропускаются без ошибки.
Ответ
Для запросов, связанных с созданием и редактированием:
[
<long>, /* ID задания */
{
"id":<long>, /* ID задания */
"n":"<text>", /* имя */
"d":"<text>", /* описание */
"m":<uint>, /* максимальное количество выполнений, 0 — не ограничено */
"st":{ /* состояние */
"e":<uint>, /* включено/отключено */
"c":<uint>, /* количество выполнений */
"l":<uint> /* время последнего выполнения */
},
"act":"<text>", /* действие */
"ct":<uint>, /* время создания */
"mt":<uint> /* время последнего изменения */
}
]
Все доступные типы действий описаны в разделе Типы действий.
Для запросов, связанных с удалением:
[
<long>, /* ID задания */
null
]
Возможные коды ошибок:
| Код | Описание |
|---|---|
| 7 | Ресурс не существует, или у пользователя нет права доступа Создание, редактирование и удаление заданий к нему. |
| 6 | Неопределенная ошибка. |
| 4 | Неверные входные параметры. |