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.