Documentation
Table of Contents
task.create
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(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 Áú»¢¶Ä²©
- 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
- ²Ñ¨¦³Ù°ù¾±³¦²¹ dependiente
Si la m¨¦trica o la regla de descubrimiento es del tipo "²Ñ¨¦³Ù°ù¾±³¦²¹ dependiente", entonces la m¨¦trica principal de nivel superior debe ser del tipo:
- Agente Áú»¢¶Ä²©
- 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 items. Uno es un item y el otro es una regla de descubrimiento de bajo nivel.
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 6,
"request": {
"itemid": "10092"
}
},
{
"type": 6,
"request": {
"itemid": "10093"
}
}
],
"id": 1
}Respuesta:
Cree una tarea Actualizar configuraci¨®n de proxy para dos servidores proxy.
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 2,
"request": {
"proxyids": ["10459", "10460"]
}
}
],
"id": 1
}Respuesta:
Cree una tarea informaci¨®n de diagn¨®stico.
{
"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:
Ver tambi¨¦n
- Tarea
- Objeto de solicitud 'Ejecutar ahora'
- Objeto de solicitud de 'informaci¨®n de diagn¨®stico'
- Objeto de solicitud de estad¨ªstica
Fuente
CTask::create() en ui/include/classes/api/services/CTask.php.