Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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 métricas 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 llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto/matriz) Una tarea para crear.

El método acepta tareas con las [propiedades de tarea estándar] (object#task-object).

Tenga en cuenta que las tareas 'Ejecutar ahora' solo se pueden crear para los siguientes tipos de métrica/reglas de descubrimiento:

  • Agente Zabbix
  • Agente SNMPv1/v2/v3
  • Comprobación sencilla
  • Control interno
  • Control externo
  • Monitor de base de datos
  • Agente HTTP
  • Agente IPMI
  • Agente SSH
  • Agente TELNET
  • Verificación calculada
  • Agente JMX
  • Métrica dependiente

Si la métrica o la regla de descubrimiento es del tipo "Métrica dependiente", entonces la métrica principal de nivel superior debe ser del tipo:

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

Valores de retorno

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

Ejemplos

Creando una tarea

Cree una tarea "Ejecutar ahora" para dos métricas. Una es una métrica y la otra es una regla de descubrimiento de bajo nivel.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 6,
                   "request": {
                       "itemid": "10092"
                   }
               },
               {
                   "type": 6,
                   "request": {
                       "itemid": "10093"
                   }
               }
           ],
           "id": 1
       }

Respuesta:

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

Crear una tarea Refrescar la configuración del proxy para dos proxies.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 2,
                   "request": {
                       "proxy_hostids": ["10459", "10460"]
                   }
               }
           ],
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1"
               ]
           },
           "id": 1
       }

Crear una tarea diagnostic information.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 1,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "proxy_hostid": 0
               }
           ],
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también

Fuente

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