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. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte User roles para obtener más información.

Parámetros

(object/array) Una tarea que crear.

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

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

  • Zabbix agent (pasivo)
  • Comprobación simple
  • SNMP agent (v1/v2/v3)
  • Zabbix interno
  • Comprobación externa
  • Monitor de base de datos
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • JMX agent
  • Calculado
  • Item dependiente
  • Script
  • Navegador
  • Consulta de telemetría

Si el item/la regla de descubrimiento es de tipo «Item dependiente», su item maestro también debe ser de uno de los tipos anteriores.

Valores de retorno

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

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.