Áú»¢¶Ä²©

task.create

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

object task.create(object/array tasks)

Aquest m¨¨tode permet crear una tasca nova (com ara recopilar dades de diagn¨°stic o verificar elements o regles de descoberta de baix nivell) sense tornar a carregar la configuraci¨®.

Aquest m¨¨tode nom¨¦s ¨¦s disponible per a usuaris del tipus Super admin. Els permisos per invocar el m¨¨tode es poden revocar a la configuraci¨® del rol d'usuari. Consulteu Rols d'usuari per obtindre m¨¦s informaci¨®.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object/array) Crear una tasca.

El m¨¨tode admet tasques amb les propietats est¨¤ndard.

Tingueu en compte que les tasques 'Comprovar ara' nom¨¦s es poden crear per als tipus d'objectes/regles de descoberta seg¨¹ents:

  • Agent Áú»¢¶Ä²©
  • Agent SNMPv1/v2/v3
  • Comprovaci¨® simple
  • Comprovaci¨® interna
  • Comprovaci¨® externa
  • Monitor de base de dades
  • Agent HTTP
  • Agent IPMI
  • Agent SSH
  • Agent TELNET
  • Verificaci¨® calculada
  • Agent JMX
  • Element dependent

Si l'element o la regla de descoberta ¨¦s del tipus "Element dependent", llavors el nivell m¨¦s alt de l'element mestre ha de ser del tipus:

  • Agent Áú»¢¶Ä²©
  • Agent SNMPv1/v2/v3
  • Comprovaci¨® simple
  • Comprovaci¨® interna
  • Comprovaci¨® externa
  • Monitor de base de dades
  • Agent HTTP
  • Agent IPMI
  • Agent SSH
  • Agent TELNET
  • Verificaci¨® calculada
  • Agent JMX

Valors retornats

(object) Retorna un objecte que cont¨¦ els ID de les tasques creades sota la propietat taskids. L'ordre dels ID retornats correspon a l'ordre de les tasques transmeses.

Exemples

Creaci¨® d'una tasca

Creeu una tasca "Executar ara" per a dos elements. Un ¨¦s un element, l'altre ¨¦s una regla de descoberta de baix nivell.

±Ê±ð³Ù¾±³¦¾±¨®:

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

Response:

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

Create a task Refresh proxy configuration for two proxies.

Request:

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

Response:

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

Create a task diagnostic information.

Request:

{
           "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
       }

Resposta:

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

Veieu tamb¨¦

Font

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