task.create

Beschrijving

object task.create(object/array tasks)

Deze methode maakt het mogelijk om een nieuwe taak te maken (zoals het verzamelen van diagnostische gegevens of het controleren van items of ontdekkingsregels op laag niveau zonder configuratieherladen).

Deze methode is alleen beschikbaar voor gebruikers van het type Super admin. Toestemming om de methode op te roepen kan worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Een taak om te maken.

De methode accepteert taken met de standaard taakeigenschappen.

Let op: 'Nu uitvoeren'-taken kunnen alleen worden gemaakt voor de volgende typen items/discovery-regels:

Zabbix-agent
SNMPv1/v2/v3-agent
Eenvoudige controle
Interne controle
Externe controle
Database monitor
HTTP-agent
IPMI-agent
SSH-agent
TELNET-agent
Berekende controle
JMX-agent
Afhankelijk item

Als een item of ontdekkingsregel van het type "Afhankelijk item" is, dan moet het bovenliggende hoofditem van het volgende type zijn:

Zabbix-agent
SNMPv1/v2/v3-agent
Eenvoudige controle
Interne controle
Externe controle
Database monitor
HTTP-agent
IPMI-agent
SSH-agent
TELNET-agent
Berekende controle
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

Taak maken

Maak een taak "Nu uitvoeren" voor twee items. De ene is een item, de andere is een ontdekkingsregel op laag niveau.

Verzoek:

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

Reactie:

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

Maak een taak "Vernieuw proxyconfiguratie" voor twee proxies.

Verzoek:

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

Reactie:

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

Maak een taak "diagnostische informatie".

Verzoek:

{
           "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
               }
           ],
           "id": 1
       }

Reactie:

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

Zie ook

Bron

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

Documentation

task.create

Beschrijving

Parameters

Retourwaarden

Voorbeelden

Taak maken

Zie ook

Bron