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

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.