task.create

Descripció

object task.create(object/array tasks)

Aquest mètode permet crear tasques.

Aquest mètode és disponible per a qualsevol tipus d'usuaris (usuaris del tipus Admin i Usuari des de Zabbix 7.0.19). Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu els 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 (passiu)
  • Comprovacions simples
  • Agent SNMPv1/v2/v3
  • Comprovació interna
  • Comprovació externa
  • Monitor de base de dades
  • Agent HTTP
  • Agent IPMI
  • Agent SSH
  • Agent TELNET
  • Agent JMX
  • Verificació calculada
  • Element dependent
  • Script
  • Navegador

Si l'element/regla de descoberta és del tipus "Element dependent", el seu element mestre també ha de ser d'un dels tipus anteriors.

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.