Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
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 una nueva tarea (como recopilar datos de diagnóstico o comprobar 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 admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para 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 'Ejecutar ahora' solo se pueden crear para los siguientes tipos de métricas/reglas de descubrimiento:

  • Agente Zabbix
  • Agente SNMPv1/v2/v3
  • Comprobación simple
  • Comprobación interna
  • Comprobación externa
  • Monitor de base de datos
  • Agente HTTP
  • Agente IPMI
  • Agente SSH
  • Agente TELNET
  • Comprobación calculada
  • Agente JMX
  • Métrica dependiente

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

  • Agente Zabbix
  • Agente SNMPv1/v2/v3
  • Comprobación simple
  • Comprobación interna
  • Comprobación externa
  • 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 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

Creando una tarea

Cree una tarea Ejecutar ahora para dos métricas. Una es una métrica, la otra es 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 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 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.