You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

task.create

Descripció

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ó.

Paràmetres

(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 Zabbix
  • 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 Zabbix
  • 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.

Petició:

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