Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

task.create

Descripción

object task.create(object/array tasks)

Este método permite crear tareas.

Este método está disponible para usuarios de cualquier tipo (para usuarios de tipo Admin y User desde Zabbix 7.0.19). Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(objeto/array) Una tarea a crear.

El método acepta tareas con las propiedades estándar de la tarea.

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

  • Agente Zabbix (pasivo)
  • Comprobación simple
  • Agente SNMP (v1/v2/v3)
  • Zabbix interno
  • Comprobación externa
  • Monitor de base de datos
  • Agente HTTP
  • Agente IPMI
  • Agente SSH
  • Agente TELNET
  • Agente JMX
  • Calculado
  • Elemento dependiente
  • Script
  • Navegador

Si el elemento/regla de descubrimiento es de tipo "Elemento dependiente", entonces su elemento maestro también debe ser uno de los tipos anteriores.

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

Creación de una tarea

Cree una tarea de 'Ejecutar ahora' para un elemento y una regla de bajo nivel de descubrimiento.

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
       }

Cree una tarea de 'Actualizar configuración del proxy' para dos proxies.

Solicitud:

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

Respuesta:

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

Cree una tarea de 'Información de diagnóstico'.

Solicitud:

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

Respuesta:

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

Véase también

Fuente

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