update_job
El método update_job se usa para crear, modificar o eliminar tareas.
svc=resource/update_job¶ms={
"itemId":<long>,
"id":<long>,
"callMode":"<text>",
"n":"<text>",
"d":"<text>",
"r":"<text>",
"at":<uint>,
"m":<uint>,
"fl":<uint>, /* opcional: 1 (eliminar la tarea después de su primera ejecución), 0 (conservar la tarea). Por defecto: 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>",
...
}
}
}
Parámetros
| Nombre | Descripción |
|---|---|
| itemId | ID del recurso. |
| id | ID de la tarea (0 para crear una tarea). |
| callMode | Acción: crear, modificar, eliminar. |
Otros parámetros solo se requieren para creación o modificación. Vea la página get_job_data.
Las unidades y los grupos de unidades especificados en el parámetro units de la acción de la tarea (act.p.units) se agregan a la tarea solo si el creador del recurso tiene el derecho de acceso Utilizar unidad en tareas, notificaciones, rutas, repetidores sobre ellos. Las demás unidades se omiten sin error.
Respuesta
Para las solicitudes de creación o modificación:
[
<long>, /* ID de tarea */
{
"id":<long>, /* ID de tarea */
"n":"<text>", /* nombre */
"d":"<text>", /* descripción */
"m":<uint>, /* cantidad máxima de ejecuciones, 0 (sin límite) */
"st":{ /* estado */
"e":<uint>, /* activado/desactivado */
"c":<uint>, /* cantidad de ejecuciones */
"l":<uint> /* la hora de la última ejecución */
},
"act":"<text>", /* acción */
"ct":<uint>, /* hora de creación */
"mt":<uint> /* hora de la última modificación */
}
]
Todos los tipos de acciones posibles se describen en la sección Tipos de acciones.
Para las solicitudes de eliminación:
[
<long>, /* ID de tarea */
null
]
Los códigos de errores posibles son:
| Código | Descripción |
|---|---|
| 7 | El recurso no existe o el usuario no tiene el derecho de acceso Crear, modificar y eliminar tareas a él. |
| 6 | Error no definido. |
| 4 | Parámetros de entrada incorrectos. |