task.create

Leírás

objektum feladat.create(objektum/tömb feladatok)

Ez a módszer lehetővé teszi új feladat létrehozását (például diagnosztikai adatok gyűjtését). vagy ellenőrizze az elemeket vagy az alacsony szintű felfedezési szabályokat a konfiguráció újratöltése nélkül).

Ez a módszer csak a Super admin felhasználótípus számára érhető el. A metódus meghívására vonatkozó engedélyeket a felhasználói szerepkör beállításaiban lehet visszavonni. Lát Felhasználó roles további információért.

Paraméterek

(objektum/tömb) Létrehozandó feladat.

A módszer a következő paramétereket fogadja el.

Paraméter Típus Leírás
type
(kötelező)
integer Feladat típusa.

Lehetséges értékek:
1 - Diagnosztikai információk;
6 - Ellenőrizze most.
request
(kötelező)
object Feladatkérés objektum a feladat típusának megfelelően. A kérésobjektum helyes formátumát a Task object szakasz írja le.
proxy_hostid integer Proxy, amelyről a Diagnosztikai információs feladat adatokat gyűjt.

Figyelmen kívül hagyva az "Ellenőrzés most" feladatoknál.

Ne feledje, hogy az „Ellenőrzés most” feladatok csak a következőkhöz hozhatók létre cikktípusok/felfedezési szabályok:

  • Zabbix ügynök
  • SNMPv1/v2/v3 ügynök
  • Egyszerű ellenőrzés
  • Belső ellenőrzés
  • Külső ellenőrzés
  • Adatbázis monitor
  • HTTP ügynök
  • IPMI ügynök
  • SSH ügynök
  • TELNET ügynök
  • Számított csekk
  • JMX ügynök

If item or discovery rule is of type "Dependent item", then top level master item must be of type:

  • Zabbix agent
  • SNMPv1/v2/v3 agent
  • Simple check
  • Internal check
  • External check
  • Database monitor
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • Calculated check
  • JMX agent

Visszatérési értékek

(object) Egy objektumot ad vissza, amely tartalmazza a létrehozott feladatok azonosítóit a taskids tulajdon alatt. Minden elemhez egy feladat jön létre és alacsony szintű felfedezési szabály. A visszaküldött azonosítók sorrendje megegyezik a az átadott "tételek" sorrendje.

Példák

Creating a task

Create a task check now for two items. One is an item, the other is a low-level discovery rule.

Request:

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

Response:

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

Lásd még

Forrás

CTask::create() az ui/include/classes/api/services/CTask.php-ban.