task.create

Descripción

object task.create(object/array tasks)

Este método permite crear una nueva tarea (como recopilar datos de diagnóstico o verificar items o reglas de descubrimiento de bajo nivel sin recargar la configuración).

Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para activar el método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(object/array) Una tarea para crear.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
type (required)	número entero	Tipo de tarea. Valores posibles: 1 - Información de diagnóstico; 6 - Comprobar ahora.
request (required)	objeto	Objeto de solicitud de tarea según el tipo de tarea. El formato correcto del objeto de solicitud se describe en la sección Task object.
proxy_hostid	número entero	Proxy sobre qué tarea de información de Diagnóstico recopilará datos. Ignorado para las tareas 'Verificar ahora'.

Tenga en cuenta que las tareas 'Verificar ahora' solo se pueden crear para lo siguiente tipos de elementos/reglas de descubrimiento:

Zabbix agent
Agente SNMPv1/v2/v3
Comprobación sencilla
Control interno
Control externo
Monitor de base de datos
Agente HTTP
Agente IPMI
Agente SSH
Agente TELNET
Comprobación calculada
Agente JMX

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de las tareas creadas bajo la propiedad taskids. Se crea una tarea para cada item y regla de descubrimiento de bajo nivel. El orden de los IDs devueltos coincide con el orden de los itemids pasados.

Ejemplos

Creando una tarea

Cree una tarea "verificar ahora" para dos elementos. Uno es un elemento y el otro es una regla de descubrimiento de bajo nivel.

Solicitud:

{
           "jsonrpc": "2.0",
           "método": "tarea.crear",
           "parámetros": [
               {
                   "tipo": 6,
                   "pedido": {
                       "itemid": "10092"
                   }
               },
               {
                   "tipo": "6",
                   "pedido": {
                       "itemid": "10093"
                   }
               }
           ],
           "autenticación": "700ca65537074ec963db7efabda78259",
           "identificación": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "niños de tarea": [
                   "1",
                   "2"
               ]
           },
           "identificación": 1
       }

Cree una tarea de "información de diagnóstico".

Pedido:

{
           "jsonrpc": "2.0",
           "método": "tarea.crear",
           "parámetros": [
               {
                   "tipo 1,
                   "pedido": {
                       "alerta": {
                           "estadísticas": [
                               "alertas"
                           ],
                           "arriba": {
                               "alertas.media": 10
                           }
                       },
                       "lld": {
                           "estadísticas": "extender",
                           "arriba": {
                               "valores": 5
                           }
                       }
                   },
                   "proxy_hostid": 0
               }
           ],
           "autenticación": "700ca65537074ec963db7efabda78259",
           "identificación": 2
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "niños de tarea": [
                   "3"
               ]
           },
           "identificación": 2
       }

Ver también

Fuente

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

Documentation