task.create

Beschrijving

object task.create(object/array taken)

Met deze methode kan een nieuwe taak worden gemaakt (zoals het verzamelen van diagnostische gegevens) of controleer items of detectieregels op laag niveau zonder configuratie opnieuw te laden).

Deze methode is alleen beschikbaar voor het gebruikerstype Superbeheerder. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zien Gebruiker rollen voor meer informatie.

Parameters

(object/array) Een taak om te maken.

De methode accepteert de volgende parameters.

Parameter	Type	Beschrijving
type (verplicht)	geheel getal	Taaktype. Mogelijke waarden: 1 - Diagnostische informatie; 6 - Nu controleren.
request (verplicht)	object	Taakaanvraagobject volgens het taaktype. De juiste indeling van het aanvraagobject wordt beschreven in de sectie Taakobject.
proxy_hostid	integer	Proxy over welke taak met diagnostische informatie gegevens verzamelt. Negeerd voor 'Nu controleren'-taken.

Opmerking dat 'Nu controleren'-taken alleen voor het volgende kunnen worden gemaakt: soorten items/ontdekkingsregels:

Zabbix-agent
SNMPv1/v2/v3-agent
Eenvoudige controle
Interne controle
Externe controle
Databasemonitor
HTTP-agent
IPMI-agent
SSH-agent
TELNET-agent
Berekende cheque
JMX-agent

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte taken bevat onder de eigenschap taskids. Voor elk item wordt één taak gemaakt en detectieregel op laag niveau. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven itemids.

Voorbeelden

Een taak maken

Maak een taak 'nu controleren' voor twee items. De ene is een item, de andere is een detectieregel op laag niveau.

Verzoek:

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

Response:

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

Create a task diagnostic information task.

Request:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 1,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "proxy_hostid": 0
               }
           ],
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 2
       }

Antwoord:

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

Zie ook

Bron

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

Documentation